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PREFACE 


0.1 MANUAL OBJECTIVE AND READER ASSUMPTIONS 


The objective of this manual is to provide the user with an 
introduction to the basic concepts of RSX-11D and to describe the use 
of the terminal interface with the system. 


The manual is intended for use by two types of users: general and 
privileged. Functions available to the general user are restricted to 
those required for program development and checkout. Functions 


available to the privileged user provide the means for system control 
and modification. 


For the general user, no other manuals in the RSX-11D documentation 
set are prerequisite to the use of this manual. The privileged user, 
however, may wish to become familiar with the RSX-11D System Manager's 
Guide. —— 


0.2 STRUCTURE OF THE MANUAL 


The manual is divided into three major chapter groupings. Chapters 1 
through 4 introduce the user to the system. Chapters 5 and 6 detail 
actual system commands. Appendices A through N provide summary 
information. 


Chapter 1 through 3 provide an introduction’ to RSX~-11D, its 
components, file structure, and conventions. 


Chapter 4 describes gaining access to the system, logging onto the 
system, and using the system. 


Chapter 5 describes the system commands that are available to all 
users of the system. 


Chapter 6 describes the system commands that can only be used by 
privileged users. 


Chapter 7 describes the use of magnetic tape volumes within’ the 
system. 


Chapter 8 describes the use and operation of the system node _ pool 
program. 


Appendixes A through N contain command summaries and error messages 
for frequently-used RSX-11D components. 
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The following conventions are used to describe examples and command 
string formats: 


1. «/ indicates a RETURN. All command lines are normally 
terminated by pressing RETURN unless otherwise noted 
in the text. 


2% ($) indicates ALTmode or ESCape. 


3. In all cases, except where [UIC] or [UFD] is specified, 
brackets signify optional parameters. 


0.3 ASSOCIATED DOCUMENTS 


A synopsis of each manual in the RSX-11D documentation set is provided 
in the RSX-11D Documentation Directory, Order Number DEC-11-OXUGA-C-D. 
The directory also defines the readership of each manual in the set. 


CHAPTER 1 


INTRODUCTION 


RSX-11D is a resource-sharing executive designed to run on_ the 
PDP-11/40, PDP-11/45, PDP-11/50, and PDP-11/70. It provides an ideal 
environment for both real-time data processing and multiuser 
applications. It includes the following features: 


: Memory protection on a task-by-task* basis 


F Multiuser approach to both system-provided tasks and 
user-developed tasks 


: User-defined memory partitions 
. Modular approach to program development 


: An extensive set of monitor console routines (MCR) for task 
control from any terminal 


. MCR routines for system control 


3 A task overlay system to reduce the amount of memory required 
for tasks 


é Priority and time-slice techniques for scheduling task 
execution 


* Capability to assign priorities (1 through 250) to tasks 
F Checkpointing (roll-out/roll-in) based on task priority 


F Shared disk~resident and memory-resident libraries containing 
often-used routines 


Batch capability to allow execution of job streams read from 
a peripheral device 


‘ Macro call capability for file and I/O operations 


Device independence for 1/0 flexibility 


*A task is the basic executable unit in RSX-11D. 
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A file control system for processing RSX-~-11D standard 
(Files-1l1) disk and DECtape volumes, as well as ANSI standard 
multivolume magnetic tape 


‘ Task approach to device handlers to allow incorporation of 
user-written handler tasks 


‘ File and volume protection 

. System access protection 

‘ Capability to define task attributes during task building, 
rather than during assembly/compilation, for greater 


flexibility 


: Accounting to provide statistics of task use of system 
resources 


. Spooling of print files 

* Support of Massbus devices 

. Support of analog/digital devices 

‘ Automatic logging of hardware errors 

: On-line diagnostics capability 

7 Power recovery support 

‘ System-performed memory parity checking 


‘ System generation capability, on-line or off-line 


1.1 RSX-11D COMPONENTS 
The RSX-11D system consists of the following software components: 
An Executive to control the internal operation of the system 


‘ A set of monitor console routines (MCR) that enable the user 
to communicate with the system 


‘ An additional set of MCR commands that allow centralized 
control of the system 


‘ A FORTRAN compiler and object time system (OTS) and a MACRO 
assembler 


R A task builder to create loadable task images from 
relocatable object modules 


- Utility programs 
‘ File control services (FCS) 
: Device handler tasks to service I/O requests 


R On-line debugging aid (ODT) and trace capability to assist in 
program development 
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‘ Batch stream processor 

System generation package 

é Task accounting package 

° Hardware error logging package 


: System test package 


1.2 RSX-11D EXECUTIVE 


The main function of the RSX-11D Executive is system control (e.g., 
scheduling tasks, controlling task interaction, checkpointing, placing 
tasks in partitioned memory, and interfacing with the user via MCR). 
The Executive also provides the user with a set of system directive 
commands which can be included in MACRO and FORTRAN programs’ to 
request Executive services. 


System directive commands provide the following services for executing 
tasks: 


. Starting, scheduling, canceling, terminating, and resuming 
other tasks 


. Fixing a task in memory or releasing it 
‘ Enabling a task to run or disabling it 
‘ Enabling or disabling checkpointing for a task 


‘ Obtaining information about the status of tasks 


‘. Setting event flags, testing them, and performing other 
capabilities related to event flags 


; Handling software and hardware interrupts (RSX-11D traps) 
‘: Handling input/output 


The Executive is described in detail in the RSX-11D Executive 
Reference Manual. 


1.3 MONITOR CONSOLE ROUTINES (MCR) 


The monitor console routines (MCR) provide an interface between’ the 
user and the system. MCR provides the user with complete task control 
features. The user issues MCR commands to request system programs 
(e.g., FORTRAN for task development) and _ to schedule and execute 
tasks. 


From MCR, the user can obtain the following information about’ the 
system: 


a The time of day and date 


5 A list of active tasks 
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Fs A list of partitions and common areas 


; A list of the physical devices for which the system was 
generated 


. A list of the logical units and their associated physical 
devices for a task 


In addition, the user can log information about the system. 
The MCR commands for the above functions are described in Chapter 5. 


MCR also provides the user with the capability to initialize RSX-11D 
file-structured (Files-1l) volumes, to mount and dismount Files-1ll 
volumes, to establish user file directories (UFDs), and to establish 
passwords. (Files-1ll and UFDs are discussed in Section 3.2). These 
and other MCR commands used for centralized control of the system, 
including the capability to enter time and date and to control spooler 
Operation, are described in Chapter 6. 


1.4 FORTRAN LANGUAGE AND OBJECT TIME SYSTEM 


RSX-11D FORTRAN is an ANSI standard FORTRAN IV language accompanied by 
an object time system (OTS). FORTRAN programs can be compiled into 
object code, or they can be converted into assembly-language source 
statements that, in turn, can be assembled with other 
assembly-language modules. 


The OTS is an object library of commonly used FORTRAN routines’ that 
can be called by FORTRAN programs. The user selects the OTS library 
that is appropriate for his applications. 


1.5 MACRO ASSEMBLER 


The RSX-11D MACRO assembler allows the user to take full advantage of 
the PDP-11l programming language, system directives, and the RSX-11D 
file control services (FCS). (See section 1.8.) During assembly, 
MACRO detects errors and produces output indicating the type of errors 
found, thus simplifying the process of locating program errors. 


1.6 TASK BUILDER 


The task builder creates loadable core images from assembled or 
compiled tasks. It links relocatable object files and resolves any 
references to global symbols, common areas, and shared libraries. The 
task builder also provides an overlay descriptor language to construct 
task overlays. The overlay descriptor language simplifies the process 
of dividing a task into overlaid segments and specifying loading 
methods. 


The task builder provides switches that specify certain task 
attributes. Because switch information is specified during task 
building, such information can be changed without reassembling or 
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recompiling the task. The switches indicate the following: 
i Whether the task can be checkpointed. Normally, tasks’ that 
are not time critical when a higher priority task is 
requested are regarded as checkpointable 


é Whether the task can be aborted by the operator or by an 
Executive directive 


: Whether the task is multiuser 
é Whether the task is privileged 


; Whether the task uses the floating point processor (not 
available on PDP-11/40) 


° Whether the task is subject to accounting 
a Whether the task may be fixed in memory and other’ factors 
that control the execution of the task and define its 
attributes 
The task builder stores the task on disk in a form that can be 


dynamically loaded anywhere in the system's memory; the task is not 
restricted to operating in a fixed memory area. 


1.7 UTILITY PROGRAMS 
The RSX-11D utility programs described in the following sections 


permit file operations such as copying, editing, transferring, 
verifying, compressing, dumping, modifying, and creating libraries. 


1.7.1 Peripheral Interchange Program (PIP) 


PIP is used to copy files from one device to another, for example, 
from disk to printer, to rename files, to list files, and to delete 
files. 


1.7.2 Editor (EDT) 
EDI is used to enter source programs into the system and to modify 


them as needed. A large set of easy-to-use commands makes EDI an 
effective program development tool. 


1.7.3 File Transfer Program (FLX) 


FLX performs the following file conversions: 
: From DOS-11 to Files-1l1 format 


‘ From Files-ll to DOS-1l1l format 
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. From RT-11 to Files-1l format 
, From Files-1l to RT-11 format 
‘ From DOS-11 to DOS-11 format 
- From RT-11 to RT-11 format 


: From Files~1ll to Files-1ll format 


FLX also allows the user to: 


1. List directories of cassettes, RT-1l1 volumes, or DOS-11 
volumes 


2. Delete files from DOS-11 and RT-11l volumes 


3. Initialize cassettes, RT-11 volumes, or DOS-1l11 volumes 


1.7.4 Verification (VFY) 


VFY checks the consistency and accuracy of system files on a Files-1l 
device (for example, disk). It also prints the number of available 
blocks in a volume, locates files that could not otherwise be 
accessed, and lists the names of files for the volume's index file. 


1.7.5 Source Language Input Program (SLP) 


SLP is a batch-oriented editing program that is used to create and 
maintain source language files on disk. 


1.7.6 File Compression (SQZ) 


SQZ removes unnecessary spaces and tabs from MACRO source program 
files. Additionally, the SQZ program removes comment lines. The 
resultant file requires less storage space. 


1.7.7 Dump Utility (DMP) 


DMP enables the user to obtain a printout of files, in either ASCII or 
octal format. 


1.7.8 Librarian (LBR) 


LBR provides the user with the capability to create and maintain 
disk-resident libraries of object and source modules. 
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1.7.9 ZAP Utility Program (ZAP) 


The ZAP utility program provides a facility for examining and 
modifying task image files and data files. With ZAP, permanent 
patches can be made to task image or data files without having’ to 
recreate the file. 


1.8 FILE CONTROL SERVICES 


File control services (FCS) provide the user with record-oriented and 
block-oriented file I/O and additional functions required for file 
control, such as open, close, and delete operations. At the’ FCS 
level, the user issues macro calls to specify desired file control 
operations. 


FCS supports both sequential and direct access files. Sequential 
access is device independent and can be used for both record-oriented 
and Files-ll structured devices. Direct access is used for Files-1l 
structured devices only. Data records can be either fixed length or 
variable length. 


When record I/C is used, a program can gain access to. individual 
records in either of two ways: 


1. By moving the data to a user-defined buffer (move mode), 


2. By using FCS parameters to index into the desired block 
buffer and process the data there (locate mode). 


When block I/O is used, a program can gain access to an entire file 
block. This file block is delivered to a user-specified buffer within 
the user program. This allows the user to eliminate the space and 
time overhead associated with record buffering. By opening the file 
as either a single-user or a shared file, a task can indicate whether 
other tasks can gain access to the file during its processing. Access 
can also be restricted by assigning specified volume and file access 
protection to a volume or file. See Section 3.2.8. 


1.9 DEVICE HANDLER TASKS 


In RSX-11D, support of PDP-11 devices is provided by device handler 
tasks which perform the necessary functions that enable physical I/O 
operations. 


Because device handlers are tasks within RSX-11D, the user does not 
fill memory with handlers that are not required. Infrequently-used 
handlers can be loaded when needed by the user and then unloaded after 
use. 


In addition, because handlers are tasks, the user can write his own 
handlers to service nonstandard devices. See the IAS/RSX-11D Guide to 
Writing Device Handler Task. 
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1.10 ON-LINE DEBUGGING TECHNIQUE 


The on-line debugging technique (ODT) for RSX-11D is a system aid for 
debugging programs that have been assembled or compiled and task 
built. From the keyboard, the user interacts with ODT to achieve’ the 
following results: 


' Print the contents of any location in the task for 
examination or alteration. 


‘ Run the entire program or any portion of it using’ the 
breakpoint feature to halt the program at specified points 


: Search the program for specific bit patterns 


* Search the program for words that refer to aé_e specific 
location 


Calculate offsets for relative addresses 
‘ Fill a block of words or bytes with a designated value 


A Trace capability is also provided to aid in the debugging of FORTRAN 
and MACRO-11 programs. 


1.11 BATCH CAPABILITY 


The RSX-11D batch facility provides for job execution in background 
mode. Each job can consist of control information and data. Control 
information includes such functions as requests to compile or assemble 
tasks and to execute’ them. A variety of switches gives the user 
desirable options. 


The batch stream is read onto disk from a peripheral device, for 
example, a card reader. Once on the disk, the system examines the job 
requests and schedules them. 


1.12 SYSTEM GENERATION 


The RSX-11D software system distributed to the user is capable of 
performing all system functions once it is built onto the system disk. 
However, RSX-11D provides a system generation program that can be used 
to tailor the system to the processing requirements of individual 
installations. 


1.13 TASK ACCOUNTING 

RSX-11D accounting facilities enable the system manager to determine 
how executing tasks are using the system resources. Accounting 
statistics provide the following information for each task: 


- The amount of computer memory used 


‘ The elapsed execution time 
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‘ Central processor time used 

: Peripheral device access count 

é A log of the I/O 

. Disk storage in use for individual disk areas. 


Task accounting is described in detail in the RSX-11D System Manager's 
Guide. Sr 


1.14 HARDWARE ERROR LOGGING 


An error logging facility is included in RSX-11D to enable the system 
Manager to determine the status of the system hardware. Error logging 
creates a file that contains a record of hardware errors occurring on 
the central processing unit and peripheral devices. The system 
Manager can request at any time, a summary of errors by device or a 
list of all errors. It is also possible to obtain a listing of errors 
that occurred during a specified time span. 


1.15 ON-LINE HARDWARE DIAGNOSTICS 


The hardware error diagnostic handlers are a complete set of special 
purpose handlers that enable the system manager to find and analyze 
problems on peripheral devices. These handlers run in parallel with 
other handlers on an active RSX-11D system. 


1.16 MEMORY PARITY CHECKING 


RSX-11D checks for the occurrence of parity errors in main memory and 
in cache on the PDP-11/70. If a parity error occurs, the system 
performs one of the following actions: 


l. If the parity error is detected in the Executive portion of 
memory, system operation halts to prevent system 
deterioration. An analytical dump of the system can then be 
taken. See the description of the core dump analyzer (CDA) 


in the RSX-11D System Manager's Guide. 


2. If the parity error is in the user's memory area, the’ system 
terminates the task, indicating that fact in the task's 
status information. 


3. If the error occurred in the PDP-11/70 cache, the system 
determines whether a user-specified limit for the number of 
error allowed in one minute has been exceeded. If it has 
been exceeded, the cache group is turned off. 


INTRODUCTION 


NOTE 


The task and memory locked down as a 
result of a main memory parity error 
cannot be used until they are released 
by means of the MEM MCR function. 


Cache errors never result in the locking 
of a task in memory. 


1.17 SYSTEM TEST PACKAGE 


The system test package is designed to systematically test the PDP-1l 
software while it is running RSX-11D. The hardware is also tested by 
a subset of the test tasks. 
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FUNDAMENTAL RSX-11D CONCEPTS 


RSX-11D schedules tasks to execute in defined areas of memory called 
partitions. The concepts of partitions, tasks, and scheduling are 
essential to an understanding of the capabilities and flexibility of 
the RSX-11D system. 


2.1 PARTITIONS 


Partitions contain executing tasks and tasks that are permanently 
resident (fixed) in memory, regardless of whether they are executing. 
When an RSX-11D system is generated, the system manager defines’ the 
size and number of partitions to suit the hardware configuration and 
processing needs. All memory not required for the RSX-11D Executive 
and system subroutines is available for partitions. The system 
Manager specifies the name, size, and base address of each partition 
and also indicates whether it is user-controlled or system-controlled. 


Unless a task is fixed in memory, it is automatically removed from the 
partition upon termination. A fixed task can be unfixed only when it 
is quiescent. 


2.1.1 User-Controlled Partitions 


A user-controlled partition can contain only one task at a time. 
Because the user has complete control over activity in sucha 
partition, it provides an ideal environment for a real-time 
application. The exact partition size can be specified for tasks that 
are normally resident, permitting maximum use of memory. 


2.1.2 System-Controlled Partitions 


A system-controlled partition, one in which the RSX-11D Executive 
handles task execution, can contain one or more tasks at a time. The 
system controls the placement of tasks in memory. The only 
restriction is that a task cannot be loaded into a partition until 


there is enough contiguous memory available within the partition. 


The system-controlled partitions are intended for the execution of 
user tasks that do not necessarily have real-time requirements, MCR 
functions, and other system-related tasks (for example, the T1/0O 
system)... See Figure 2-1 for an example of memory divided into 
user-controlled and system-controlled partitions. 
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System controlled partitions can operate on either a priority basis or 
On a time~scheduled basis as defined by the system manager during 
system generation. The sequence of events’) that occur in a 
priority-oriented partition is described in the RSX-11D Executive 
Reference Manual. The algorithm for the time-scheduled partition is 
described in the RSX-11D System Manager's Guide. 


Because of the large overhead required, tasks are not moved in memory 
during execution to make room for additional tasks. If sufficient 


memory is available within a partition, however, additional tasks can 
be loaded. 


RSX~-11D 
EXECUTIVE 
AND 
SYSTEM SUBROUTINES 


Teletype Handler User-Controlled Partition 
Disk Handler User-Controlled Partition 


Mcr Functions 
System-Controlled Partition 
MCR Dispatcher 


enered reas System-Controlled Partition 


Memory 
Area User-Controlled 
Partition User-Controlled Partition 
Running One Task 


Figure 2-1 
Physical Memory Divided Into Partitions 
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2.1.3 Memory Protection 


The memory area allocated to a task is accessed via memory management 
hardware. A task's memory area is protected from other’ tasks 
executing in the system; and the tasks can access only those areas 
allocated to it. Access rights, read or write, are also controlled by 
the hardware. 


Those portions of memory that are used by one or more tasks, such as 
shared libraries and common areas, also are _ protected. Shared 
libraries can be used by many tasks. For this reason, they are 
re-entrant (read only). Common areas can be either pure or impure 
(read/write); and the memory management hardware controls access. 
Care must be taken when a common area is shared between tasks with 
read/write access. In this case, the burden is on the programmer’ to 
maintain synchrony. 


2.2 TASKS 


A task is the basic executable unit in RSX-11D. Once a source’ task 
has been assembled or compiled, task built to make it relocatable, and 
installed into the system, it is referred to as a task. One or more 
source programs can be combined during assembly/compilation or task 
building to form one task. 


When a task is installed in RSX-11D, the system establishes an entry 
in an in-memory directory called the system task directory (STD). 
This entry holds information concerning the task's image on disk. 
When a request for task execution is made, the system uses this 
pointer to load the task image into memory and start its execution. 
Tasks can also be fixed in memory, to allow faster task initiation and 
rescheduling by the system. Each task can execute independently or in 
conjunction with other tasks’ in its own or other partitions. Such 
task interaction is described in Section 2.2.3. Tasks can be 
requested for execution in any of the following ways: 


- By a user at a terminal 
- By an executing task 
- By a request in a batch stream 


- Through a time-dependent schedule 


2.2.1 Overlays 


RSX-11D supports an overlay development function that can be used _ to 
reduce the amount of memory required for a program. For example, a 
task can be divided into several segments: a main segment that must 
be resident throughout task execution and other segments that are used 
less frequently, which are loaded into memory only when needed. 


Segments can control program operation by calling other segments. The 
called segments constitute the overlays. An overlay is brought into 
memory to replace resident code that is no longer needed. The main 
segment also provides a storage area for information that is to be 
passed from overlay to overlay. 


The memory requirement for the overlay area is equivalent to the size 
of the largest overlay. The memory requirement for the task is the 
area of the main segment plus the area required for the largest 
overlay. 


2-3 


FUNDAMENTAL RSX-11D CONCEPTS 


As an example of overlaying, consider the program whose task structure 
is depicted in Figure 2-2. The program consists of five segments: a 
main segment, and segments A, B, C, and OD. Segments C and D can 
overlay each other. Within segments C and D, certain portions can 
also be overlaid. Figure 2-2 illustrates the space required for the 
program on disk and the memory area reguired for the program's 
execution. 


Space for C and Cl, 
Cl and C2, OR Space 
for D, Dl and D2, 
OR Dl, D2, and D3 


Figure 2-2 
Overlay Structure 
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2.2.2 Multiuser Tasks 


A multiuser task can be requested for execution by more than one user. 
For example, terminals 5, 7, and 8 can run the same task 
independently. Both system tasks and user-written tasks can be built 
as multiuser tasks. 


In many cases, multiuser tasks are divided into pure and impure areas. 
The term pure area indicates that the area remains unchanged during 
task execution (has read-only access). The term impure area indicates 
that the area is modified during execution (has read/write access). 


When a task consisting of a pure and an impure area iS run by more 
than one user, only one copy of the pure area resides in memory. One 
copy of the impure area is required for each user. Figure 2-3 depicts 
a partition containing multiuser’ tasks. Therefore, dividing a 
multiuser task into pure and impure areas results in conservation of 
memory for the executing tasks. 


2.2.3 Task Interaction 


Because many tasks can execute at the same time, four techniques’ for 
task interaction are provided: global event flags, a common area, 
shared access to data files, and SEND/RECEIVE Executive directives. 


RSX-11D provides a set of 32 global event flags that can be set and 
tested by all tasks in the system. Using the global flags, a task can 
wait for another task to perform a designated function before resuming 
execution. The waiting task tests a specified event flag; when the 
executing task has performed the designated function, it sets’ the 
flag, thus allowing the waiting task to resume. The use of global 
event flags should be coordinated by the system manager. Figure 2-4 
depicts the use of event flags. 


Common areas are read-write shareable global areas (see Section 2.7) 
and are created and installed in the same way as tasks. Figure 2-5 
shows the use of the common area for intertask communication. Many 
tasks can read from or write into common areas. Thus, a task can read 
information from an I/O device, store it in a common area, and set a 
global event flag to notify another task that data is available for it 
in that common area. 


Shared data files provide the same function aS common areas except 
that they are maintained on a Files-1ll volume rather than in main 
memory. 


SEND/RECEIVE Executive directives allow tasks to transmit data using 
the system node pool as the data storage medium. 


FUNDAMENTAL RSX-11D CONCEPTS 


TASK A PURE AREA 
Terminal 5 ' TASK A IMPURE AREA 


OTHER ESECUTING TASKS Partition 


Terminal 7 —.> TASK A IMPURE AREA 
Terminal 8 —> TASK A IMPURE AREA 


Figure 2-3 
Multiuser Tasks 


Global 
33 34 35 Event Flags 


USER TASK A Waits for flag 35 to be set 
USER TASK B Sets flag 35 after specified event 


Figure 2-4 
Use of Event Flags for Intertask Communication 
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RSX-11D EXECUTIVE 


Shared Libraries 


Puts Data 
in the 
Common Area User Task A 


User Task B Removes Data 
from the 
Common Area 


Common Area 


Figure 2-5 
Use of the Common Area for Intertask Communication 


2.3 SCHEDULING TASK EXECUTION 


Under RSX-11D, a task can be requested for immediate execution or it 
can be scheduled for execution at a later time. The scheduling 
request can originate from the user or from another executing task. 
In a priority-oriented partition, scheduling always depends on task 
priority (1 through 250; where 250 is the highest or most urgent 
priority) and memory availability within the desired partition. Ina 
time-scheduled partition, scheduling always depends on the time 
scheduler, which give each task in turn an opportunity to execute. 


In addition to the scheduling performed automatically in a partition 


by the Executive, the user can schedule tasks based on any of the 
following factors: 


and 
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. A request to execute the task in a number of minutes, seconds, or 
clock ticks from the issuance of the request, for example, in 30 
minutes, and optionally, to reschedule the task at specified 
intervals. 


. A request to execute the task at a certain time of day and at 


specified intervals thereafter; for example, at 10:00 p.m. and 
every ten minutes thereafter. 


. Synchronization with the next clock tick, second, minute, or 
hour, and optionally, to reschedule the task at specified 
intervals. 


When a task of a higher priority than the currently running task is 
scheduled for execution in a priority-oriented partition, the task 
currently in memory is checkpointed and replaced by the higher 
priority task if necessary. See Section 2.4. 


Both the terminal user and tasks executing within the system can 
affect the order of task execution. If necessary, the user can cancel 
the scheduled request and then reschedule’ tasks at specified 
intervals. 


2.4 CHECKPOINTING 


Checkpointing is the option of suspending the operation of one task to 
allow the running of another task. The suspended task is placed on a 
user-~designated checkpoint disk device in a form that allows’ the 
system to reload and restart the task when memory is again available. 
The task is restarted from the interruption point, not from the 
beginning. 


In a system-controlled, priority-oriented partition, checkpointing 
occurs to allow the running of a task with a higher priority. Ina 
system-controlled, time-scheduled partition, checkpointing can occur 
when the currently executing task exceeds its time limit. 


At task build time the user must designate those tasks that cannot be 
checkpointed. For example, checkpointing frequently is not 
appropriate for real-time applications. Checkpointing, a 
roll-out/roll-in operation, can be used for both system-controlled and 
user-controlled partitions. 


NOTE 


A task that can be fixed in memory 
cannot be checkpointed. 


2.5 DEVICE INDEPENDENCE 


One of the major factors in determining whether a program can run is 
resource availability, that is, whether the necessary peripheral 
devices are free for use. To allow greater flexibility in the area of 
resource availability, RSX-11D provides device independence. This 
feature permits a programmer to code a program with input and output 
assigned to logical units rather than to specific physical devices. 
Before scheduling the task for execution, the user can assign physical 
devices to the logical units specified in the task's I/O. If the task 
uses the default device assignments, that is, devices that are readily 
available for use, the user need not assign devices. 
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2.6 PRINT FILE SPOOLING, DESPOOLING, AND INPUT SPOOLING 

RSX-11D provides three types of file spooling: 
1. Automatic output spooling to disk, 
2. Automatic despooling of disk files queued for printing, 
3. Automatic input spooling from a card reader to disk. 


Output spooling eliminates program contention for line printers, 
teleprinters, and other serial output devices. Because programs do 
not have to wait to use a serial device, higher system throughput is 
achieved. 


The need to wait for a particular device is removed by temporarily 
redirecting the output intended for the serial device to a disk file. 
This temporary redirection is defined as automatic output spooling. 
The files redirected to the disk are later produced on the original 
device. This process is defined as despooling. 


RSX-11D provides two levels of automatic output spooling/despooling. 
On the simplest level, the automatic output spooler can queue files 
for the single device despooler which prints them one at a time on a 
first-in/first-out basis. Only one output device is used at a time. 


On a more sophisticated level, the automatic output spooler and_e the 
terminal user both can queue files for printing. In this case, the 
multiple device despooler is used. It sends queued files for printing 
on a priority basis. Up to 28 devices can be used for despooled 
output simultaneously. 


The input spooler eliminates program contention for the card reader 
and serves as a batch job input device. Card files are read onto a 
disk and placed under a specified UFD (see Section 3.2.5). 


NOTE 


Spooling can be enabled and disabled 
only by a privileged user. 


2.7  SHAREABLE GLOBAL AREAS 


Shareable global areas (SGAs) consist of shareable task image 
libraries and common areas. SGASsS are created by the task builder, and 
are stored on disk. 


Shareable task image libraries provide a storage area for subroutines 
that perform often-needed functions, for example, file control 
services (FCS) routines. By installing such subroutines in the 
system, the user avoids their duplication into each task that requires 
them. The one copy stored in the library can be used by all_ tasks 
without requiring additional physical space in the task's area of 
memory, although the task's address space is used. 


Shareable libraries are dynamically loaded into memory when aé_e task 
that uses them becomes active and are automatically released from 
Memory when they are no longer required by any task running in_ the 
system. 
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Common areas are normally used to pass shared data from one executing 
task to another (see Section 2.2.3) (for example, commonly-used tables 
of reference data). Like shared libraries, they are dynamically 
loaded when required, but are written back to disk when released on 
the assumption that the data has been modified. 


Like tasks, SGAs are files on disk. Therefore, all the file 
protection conventions described in Section 3.2 apply. [In addition, 
there is a set of access rights assignable to the code and data of 
SGAs. When a task binds to an SGA, the requested access is specified. 
When the SGA is installed, the access permitted to binding tasks is 
specified. Finally, on installation of the task, the access requested 
by the task is validated against that permitted by the SGA as 
installed. 


NOTE 


SGAsS can be installed only by a 
privileged user, usually, the system 
manager. 


Five SEND/RECEIVE Executive directives provide for the transfer of 
data blocks of up to 255 words from one task to another. The 
recipient task need not be in memory at the time of the transfer. The 
data blocks will be queued for the attention of the task when it 
returns to memory. SEND/RECEIVE Executive directives are described in 
the RSX-11D Executive Reference Manual. Their use is illustrated in 
Figure 2-6. 


RSX-11D Executive 


Shared Libraries 


User Task A 


Receiving block 


User Task B 


Sending block 


Figure 2-6 
Use of SEND/RECEIVE Directive 
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CHAPTER 3 


RSX-11D CONVENTIONS 


To simplify operations, RSX-11D observes certain conventions with 
respect to the following items: 


; Peripheral devices 
Files 

é Filename strings 

‘ Indirect files 

, Terminal control 


To ease the transition from other DEC systems to RSX-11D, many of the 
conventions used by other DEC systems are followed by RSX-11D. 


3.1 DEVICE-RELATED CONVENTIONS 


All peripheral devices are referred to using a 2-letter name and a 1l1- 
or 2-digit unit number’ followed by a colon (for example, DKO: and 
TT12:). If the unit number is omitted, the system uses unit 0 by 
default: for example LP: indicates line printer 0. Peripheral 
devices can be referred to by mnemonics or by pseudo-device names. 
Pseudo-devices are linked by the system manager to regular device 
mnemonics. Logical unit numbers of each task are in turn associated 
with peripheral devices to provide another level of device 
independence. Table 3-1 lists the mnemonics of devices supported by 
RSX-11D. 


3.1.1 Pseudo-Devices 


In addition to supporting actual physical devices, RSX-11D provides 
seven pseudo-devices: system disk (SY), terminal interface (TI), 
console input (CI), console output (CO), console log (CL), message 
output (MO), batch (BP), and spooling output (SP). The linking of 
pseudo-devices to physical devices permits a system manager’ to 
dynamically determine the physical devices that will send or receive 
system information. 
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Table 3-1 
RSX-11D Device Mnemonics 


TTn: (0 - 63) User Terminal 


DKn: RKO5 Disk 

DFn: RF1l1 Disk 

DPn: RP03 Disk 

DSn: RSO3 or RSO4 Disk 
DBn: RPO4 Disk 

MTn: TU10 Magnetic Tape 
MMn: TU16 Magnetic Tape 
DTn: DEC tape 


Paper Tape Punch 
Paper Tape Reader 


Line Printer 

Card Reader 
Cassette Tape 
AFC11 Analog Input 
LPS A/D Converter 
ADO1 A/D Converter 


UDC11 
Universal Digital Controller 


System Disk 


Individual Terminal Interface 
Console Input 

Console Output 

Console Log 

Message Output 

Spooling Output 


Batch pseudo-device 


3.1.2 System Device (SY) 


The system device is the disk (DK, DP, or DB) that contains’ the 
operating system currently loaded into memory. The term SY indicates 
the device on which the system disk is mounted. 
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3.1.3 Terminal Interface (TI) 


Terminal interface (TI) is the logical device specification for a 
terminal. Each terminal has a unique TI. The system uses TI to 
determine which terminal requested execution of a specific task. For 
identification purposes each task is assigned the TI of the requesting 
terminal. When more than one user has activated the same task, the 
task name and TI assignment provide the system with a means of 
determining which task is associated with a particular terminal. 


3.1.4 Console Input (CI), Console Output (CO), and Console Log (CL) 


Pseudo-device CI is used by the system manager to communicate with the 
system. 


Pseudo-device CO is used by the system to communicate with the system 
Manager. 


Pseudo-device CL is used for the listing of files; normally output is 
directed to the printer. 


3.1.5 Message Output (MO) 


The pseudo-device MO is used to provide detailed error messages. When 
an error occurs, the system prints a message; however, if MO is 
loaded, more explicit information is also presented. The advantage of 
treating message output as a pseudo-device is that the MO device 
handler needs to be resident in memory only when additional messages 
would be helpful, for example, during program development. MO should 
be loaded when Utility programs are in use, because they depend 
critically on it for error message generation. 


3.1.6 Spooling Output (SP) 


Pseudo-device SP is used for all spooled output files. Use of SP 
enables the spooled output to be temporarily written to any Files-ll 
formatted device. 


3.1.7 Batch Pseudo Device (BP) 


Pseudo-device BP is used in place of TI to execute batch jobs. Use of 
BP permits the queue manager to identify those output files generated 
by tasks initiated by batch. These files are concatenated by the 
queue manager and queued for output once the batch job completes. 
Batch automatically redirects the BP device to the originating TI 
terminal. It temporarily sets both the originating TI terminal and 
the BP pseudo-device to spooling status. The TI terminal remains 
spooled for the duration of the execution of the batch job. The 
terminal reverts to its spooled or non-spooled state at conclusion of 
the batch job. 
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3.1.8 Logical Unit Numbers (LUNs) 


Logical unit numbers (LUNs) provide the mechanism for programs’ to 
INMaintain device independence. The logical unit numbers used in a 
program can be assigned by means of device mnemonics to any available 
peripheral device that performs the desired function. LUNs can be 
assigned by the programmer at assembly time or at task build time, or 
by the task at run time. Because the system provides default LUN 
assignments, it is not always necessary to assign a LUN to aé_e task. 
Default LUN assignments are listed in Table 3-2. 


Table 3-2 
Default LUN Assignments 


ASSIGNMENT 


3.2 SUPPORTED FILE STRUCTURES 


RSX-11D provides support for two file structures: Files-ll for disk 
and DECtape volumes, and ANSI Standard Level 3 for single-volume or 
multivolume magnetic tape. Because Files-1l is an integral part of 
RSX-ll and its operation, it is discussed in detail in this section. 
For an in-depth description, see the IAS/RSX-11 I/O Operations 
Reference Manual. 


ANSI Standard Level 3 conforms to the proposed revision of the 
following American National Standard document, dated June 19, 1974: 


Magnetic Tape Labels 

And File Structure 

For Information Interchange 
Order No. ANSI X3.27-1969 


ANSI Standard Level 3 is also discussed in detail in the IAS/RSX-11 
I/O Operations Reference Manual. 


3.2.1 Files-1l 


Files-1l is a general purpose file control system that provides a 
facility for the dynamic creation, extension, and deletion of files on 
disk or DECtape. 


Designed into Files-1ll is a scheme for volume and file protection 
which allows the owner of a volume or file to deny access to other 
users in the system. This scheme for volume and file protection 
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provides the key to system protection, in that only users with access 
privileges to the system device are allowed access to the system. 
Methods for gaining system access, and volume and file protection are 
explained in later sections. 


3.2.2 Files-1ll Volumes 


A Files-1l volume is a collection of files which reside on a_e single 
disk or DECtape. The system can directly address each file on the 
volume by means of file pointers which reside in the volume's 
directory files. 


Each Files-1l1l volume has two kinds of directory files that are used 
for file management: the Master File Directory (MFD) file, and the 
User File Directory (UFD) files. 


The Master File Directory (MFD) file is automatically generated by the 
file system when a volume is initialized as a Files-1l volume, and is 
used to store pointers to all of the User File Directory (UFD) files 
on the volume. MFDs are described in greater detail in Section 3.2.4. 


User File Directory (UFD) files are created as needed. They are used 
to store pointers to all of the files belonging to, or associated 
with, the user whose account number (UIC) corresponds with the UFD 
file name. UIC is described in Section 3.2.7. UFDs are described in 
greater detail in Section 3.2.5. 


3.2.3 File Format 


All Files-1l files, whether MFD, UFD, or user file, have the same 
basic format (see Figure 3-1 for illustration of a sample Files-1l 
file structure). All have a file header area, and one or more data 
area(s). 


The file header area contains all the pertinent information required 
by the file system to process the file. For the purposes of this 
introduction, the user need be familiar with only the following 
fields: 


The file owner field contains the account number (UIC) of 
the user who created the _ file. UICS are described in 
Section 3.2.7. 


- File Name Field 


The file name field contains the name assigned to the file 
when it was created. File names can be a maximum of nine 
alphanumeric characters long, and are discussed in Section 
3«3% 


. File Type Field 


The file type field contains the mnemonic that identifies 
the file by its functionality; for example, FTN defines a 
FORTRAN source file. File types are discussed in Section 
3.3% 
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Version Number Field 


The version number field identifies the particular version 
or generation of the file. Version numbers are discussed in 
Section 3.3. 


- File Protection Field 


The file protection field contains a 16-bit code that 
describes who is allowed access to the file. It also 
describes the type of access allowed (i.e., Read, Write, 
Extend, or Delete). Volume and file protection are 
discussed in Section 3.2.8. 


- Data Pointer Field 


The data pointer field describes the physical allocation of 
the file on the volume. Each data area pointer describes a 
physically contiguous portion of the file. See Figure 3-2. 


By establishing pointers to blocked data in the files header area, as 
opposed to storing the data immediately following the files header, 
the system accomplishes two things: (1) All files on the volume have 
the same structural format, regardless of functionality; (2) All 
fragmented or noncontiguous areas of the volume can be put to optimum 
use; that is, a file can be expanded by merely attaching another 
pointer to a blocked data area to its file header. 


Users should always address data in a file-relative manner. The 
translation of file-relative addresses into physical addresses is 
performed by the file system and is completely transparent to the 
user. 
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FILE HEADER AREA 


FILE OWNER FIELD (UIC) 


FILE NAME FIELD 
(from 1-9 alphanumeric chars.) 


DATA AREA A POINTER 


DATA AREA B POINTER 


DATA AREA N POINTER 


DATA AREA A 


Figure 3-l 
Sample Files-1l File Structure 


3.2.4 Master File Directory 


DATA AREA B 


The Master File Directory (MFD) is used by the file system. to 
requested UFDs. The MFD of the system device serves a dual purpose: 


it aids the file system to locate UFDs on that volume, and it is 


locate 


used 


by the operating system to identify users logging onto the system. 
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Under RSX-11D, only users with UICs (account numbers) that correspond 
to established UFD file names listed in the MFD on the system volume 
are allowed access to the system. 


The Master File Directory (MFD) is automatically generated when the 
volume is initialized as a Files-ll volume. Files-11 volumes can be 
initialized only by the system manager or another privileged user. 
See Section 6.10. 


Once the MFD file is established, the system manager or privileged 
user can begin establishing UFD files. For each UFD file created, its 
file name and location are recorded in the MFD file. 


3.2.5 User File Directory 


The User File Directory (UFD) files are used by the file system to 
locate user files that are associated with or owned by the UFD's 
owner. 


UFD files are generated, as needed, by the system manager or another 
privileged user. See Section 6.24. When a user file is created, a 
pointer to the file's header area is established in the owner's’ UFD. 
The protection attributes assigned to the UFD establish the access 
rights to the files it points to. That is, a user whose access rights 
are not consistent with the protection attributes assigned to the UFD 
is not allowed access to any of the files pointed to. See Section 
31203) 


3.2.6 File Ownership 


File ownership is determined by the UIC stored in the file owner field 
of the file header. The user whose account number (UIC) exactly 
matches the UIC stored in the file owner field is considered, by the 
system, to be the file's owner. 


3.2.7 User Identification Code 

User Identification Codes (UICS) are unique account numbers’ assigned 
to each user by the system manager. For a UIC to be valid, the system 
Manager or privileged user must have first created a corresponding UFD 
on the system device. 

UICs perform the following functions: 


1. Identify the user as one with authorized access to the 
system. See Section 5.8. 


2. Identify the user as a privileged or nonprivileged user. A 
privileged user is assigned a UIC with a group code of 10 
octal or less. 

3. Identify the user's access privileges. See Section 3.2.8. 


4. Establish the user's default UFD. See section 3.3.1. 
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NOTE 


Under RSX-11D, tasks are normally run 
using the UIC under which the user 
logged onto the system. See the 
discussion of the RUN command in Chapter 
6 for exceptions to this rule. 


Whenever a UIC specification is required, it is always enclosed in 
brackets and specified in the following format: 


[ggg ,mmm] 

where: 

ggg is an octal number ranging from 1 to 377 
representing the user's group or department 
number. 

mmm is an octal number ranging from 1 to ew 
representing the user's unique identification 
within the group or department. 

Example 

[200,200] 


3.2.8 Volume And File Protection 


Files-ll provides the user with a multilevel scheme for protecting 
volumes and files against unauthorized access. This is accomplished 
by allowing the user to specify protection attributes for the entire 
volume, as well as for each file within the volume regardless of the 
file's hierarchy or functionality. 


Four types of actions can be permitted on ae file; read, write, 
extend, and delete. Tasks that are allowed to perform any combination 
of these actions are also divided into four categories: 


- System - This category comprises all tasks that run under a 
system account number. System account numbers (UICs) 
are those having a group number of 10 octal or less; 
i.e., [2,200]. 


- Owner - This category comprises all tasks that run under a 
UIC that matches the UIC in the file's file owner 
field. 

- Group - This category comprises all tasks that run under a 


UIC whose group number matches the group number of 
the UIC in the file owner field of the file being 
accessed. 


- World - Any task not included in the _ three categories 
described above. 


Every file has a file protection field associated with its file 
header. This field contains a 16-bit code which describes the file's 
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protection attributes consistent with the categories of user’ tasks 
described above. Figure 3-3 shows the format of the file protection 
word. This 16-bit code is divided into four categories: System, 
Owner, Group, and World. Each category is subdivided into action 
fields. These action fields describe the type of action (read, write, 
extend, and delete) that each category of task is allowed to perform 
on the file. Before file access is allowed, this file protection code 
is interrogated by the file system to determine if the requesting task 
is allowed to perform a desired action. 


TT-€ 


MFD FILE 


File Owner Field 
File Name Field 
File Type Field 


Protection Field 
Data Pointer 


MFD DATA 


UFD Pointer 
UFD Pointer 


UFD POINTER 


UFD FILE 


UFD DATA 


User File Pointer 
User File Pointer 


7 


USER FILE POINTER 


Figure 3-2 
Files-1l File Access Scheme 


USER FILE 


USER FILE DATA 
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Protection 
Word 


NOTE 


Bit set means NO access permitted 


Example 


WORLD GROUP OWNER SYSTEM 


Protection fo 00 0] 
Word 11li1it21/1000]0000;0000 


In this example, all system and owner accounts are allowed 
read, write, extend, and delete access privileges; group 
accounts are allowed read, write, and extend only; and 


world accounts are denied all access privileges. 


Figure 3-3 
Format of File Protection Word 
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When a task attempts to access a volume or file, the file system 


performs 


access: 


1. 


the following checks to ensure that the user task is allowed 


The task UIC is compared to the file owner UIC to determine 
the task's category (system, owner, group, world); see 
Figure 3-4. 


When the task category is determined, the file system 
interrogates the file protection word to determine if the 
task's category is allowed access to the file. 


The file system then further analyzes the file protection 
word to determine if the function to be performed (read, 
write, extend, or delete) is an allowable function for this 
category of task. 


If all of the above checks yield positive results, that is, the task 
is authorized file access, then access is granted. 


NOTE 


This check is performed three times; 
once for the volume, once for the UFD, 
and once for the particular file. The 
task must pass all three checks. 
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Group number of task UIC 
Member number of task UIC 
Group number of file owner UIC 
Member number of file owner UIC 


Figure 3-4 
Formula For Determining Task File Access Category 
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3.3 COMMAND SYNTAX AND FILE SPECIFIERS 
The majority of commands issued to RSX-11D have the following format: 


outputfile/switch=inputfilel/switchl,inputfile2/switch2,..., 
inputfilen/switchn 


Both input and output files are designated using file specifiers. 
Input and output file specifications are separated by an equal sign 
(=). Optional switches are used to indicate desired actions. File 
specifiers have the following format: 


dev: [ufd] filename.type;version/switch 


dev: = the physical device on which the volume containing 
the desired file is mounted (for example, DKO: or 
DT1:). The colon is required as part of the 
device specifier. 


{ufd] = the user file directory containing the desired 
file. 
filename = the name of the file. In RSX-11D, filenames can 


be up to nine alphanumeric characters in length. 
Filename and type are always separated by a 
period. 


. type = a means of distinguishing among various forms of 
the same file. For example, a source FORTRAN file 
might be named COMP.FTN, while the object file 
associated with that program might be called 
COMP.OBJ. File types are discussed in Section 
35362 The file type and version are always 
separated by a semicolon. 


sversion = an octal number used to differentiate among 
versions of a file. For example, when a file is 
first entered using the Editor, it is assigned a 
version number of 1. If the file is subsequently 
opened for editing, the Editor keeps the original 
file for backup and creates a new file with the 
same filename and type, but with a version number 
Of. 2. Version numbers can range from 1 to 77777 
octal. 


/switch = is usually an optional qualifier. Switches are 
normally used either to direct the execution of a 
task, or to qualify an input parameter. 


3.3.1 Defaults in File Specifiers 


If any of the elements of the filename string, except the filename, is 
omitted, the system uses a default value. A task can establish 
defaults for a file. When a task does not specify defaults, the 
defaults listed in Table 3-3 apply. 
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Table 3-3 
Filename Specifier Defaults 


STRING ELEMENT SYSTEM DEFAULT 


If omitted in the first or only file specifier, SY 
is assumed. 


If omitted in the second through n file 
specifiers, the device, specified or default, for 
the previous file specifier is used. 


If omitted in the first or only file specifier, 
the UFD which corresponds to the UIC under which 
the task iS running is used. 


If omitted in _ the second through n file 
specifiers, the UFD, specified or default, for the 
previous file specifier is used. 


filename No default -- must be specified either explicitly 
or implicitly using an asterisk as described in 
Section 3.3.3, except in certain PIP and FLX 
strings. 


A meaningful file type (e.g., if a list file is 
created, the system assigns it a file type of 
-LST). See Section 3.3.2 for a list of default 
file types. 


sversion For input files, the most recent version number. 
For output files, the next higher version number. 
An exception is the PIP file delete function that 
requires an explicit version number; this feature 
prevents the user from inadvertently deleting the 
latest version of a file. 


3.3.2 RSX-11D File Types 


RSX-11D has a defined set of file types that the system uses when the 
type is omitted from a filename string. While the user can assign his 
own file types, the file types presented in Table 3-4 are easy to use. 
File types can be defaulted in most commands. For example, if the 
FORTRAN compiler is given the source file XYZ to compile, it 
automatically searches for filename and type XYZ.FTN. 
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Table 3-4 
RSX-11D File Specifier Defaults 


FILE TYPE MEANING 


A Batch input stream 


A file containing a list of commands to a_= system 
program (i.e., an indirect file) 


data file (as opposed to .a program file) 
directory file (e.g., a UFD directory) 
Batch execute file 

Batch FORTRAN file 


FORTRAN language source program 


Batch listing stream 
file in print-image format 
MACRO assembly-language source program 


file associated with Task Builder output 


A 
A 
A 
A 
A 
A Batch Library file 
A 
A 
A 
A 
A 


Macro library file 
An object program (output from MACRO or FORTRAN) 
overlay file 
object library file 


RSX-11D system image file, or a file generated 
the EDI utility program 


System Macro Library file 
Batch concatenated object file 
spooled output file 

Sort work file 

symbol table file 

temporary file 


file that has been task built 


RSX-11D CONVENTIONS 


3.3.3 Asterisk Conventions (wildcards) 


In addition to relying on defaults in the filename string, the user 
also can place asterisks (*) in the string to indicate a particular 
element of the string that is to be ignored (wildcard). By ignoring 
the content of elements within a string, the user can affect more than 
one file at a_ time. For example, to delete three files named 
PROG.MAC;1, PROG.OGJ;1, and PROG.TSK;1, the following wildcard 
specification can be used rather than three explicit delete requests. 


PIP>PROG.*;1/DE 
The four characters, PIP>, printed by the system as a prompting 
sequence, indicate that the PIP utility is running. PIP is used to 
delete the files. The rest of the command is typed by the user. 


If the file PROG exists with other version numbers (e.g., PROG.MAC;2), 
they are not affected by the delete request. 


Not all system programs accept wildcards; their primary use is in 
conjunction with commands to PIP. 


An asterisk can be placed in any portion of the filename string except 


the device indicator, which must always be specified or defaulted to 
SY. 


3.3.4 Examples of Command Strings 


In the following examples, the first three letters and the right angle 
bracket (>) are printed by the system. The remaining characters are 
typed by the user. 


MAC>DKO: [200,200] CRGPT=DKO: [200,200] CRGPT 


A request to assemble CRGPT.MAC and call the object program CRGPT.OBJ. 
Both files are on DKO under [200,200]. 


PIP>ABCD.MAC=ABBD.MAC/RE 


A request to rename (/RE) file ABBD.MAC to ABCD.MAC. Both files are 
on device SY under the default UFD. 


PIP>SBG.OBJ;5/DE 


A request to delete file SBG.OBJ;5. The output filename string is 
omitted because it is not applicable. 


TKB>CRGPT=CRGPT 
A request to task build the object file CRGPT.OBJ. The output is 
named CRGPT.TSK because TSK is’ the default file type for the Task 
Builder. 

PIP>CRGPT.*;*/DE 


A request to delete all files with the name CRGPT, regardless of file 
type or version. 
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3.4 INDIRECT FILES 


An indirect file is a sequential file containing a list of cammands. 
The commands contained in the file are task specific, that is, they 
can be interpreted only by a specific task such as MACRO-11l or _ the 
Task Builder. 


Rather than repeatedly typing commonly used sequences of commands, the 
user can type the sequence once and store it on a file. To execute 
the sequence, the user types an at sign (@) and then the filename. 
The affected task (for example, MACRO-11 or Task Builder) locates the 
indirect file and executes the commands contained therein. For 
example, 


MCR>MAC @CMDFIL.CMD 


In response to the command, MACRO-1l1l accesses the file CMDFIL.CMD for 
all of its commands. 


NOTE 


1. An indirect file may contain any command 
that is interpretable by the task to 
which it is directed, but no others. 


2. Indirect files can be created using the 
Editor utility program, as described in 
the RSX-11D Utility Programs Procedures 
Manual. 


3. Not all system programs allow the use of 
indirect command file specifiers. The 
user should carefully read the 
appropriate system program documentation 
before attempting to use the programs. 


3.5 TERMINAL CONVENTIONS 


Several special keyboard characters that cause specific functions’ to 
be performed are recognized by the_ system. These functions are 
described in Table 3-5. Most of them require the holding down of the 
CTRL (control) key while a second character is pressed; e.g., CTRL C. 
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Table 3-5 
Terminal Control Conventions 


KEYS FUNCTION 


RETURN 


RUBOUT 


Causes MCR to be activated. The system prints’ the 
prompt characters, MCR>. 


NOTE 


Typing CTRL C does not affect the execution 
of any tasks currently running. 


Logical end-of-file; when typed in response to a 
prompt from most system programs, causes that program 
to exit. 


Terminates the current line and causes the system _ to 
print the prompt for the next command. All lines are 
terminated using RETURN unless otherwise noted in the 
documentation. 


Causes the most recently typed character to be deleted 
from the command string. RUBOUT echoes as a backslash 
(\). Successive typing of RUBOUT causes the most 
recently typed characters to be deleted. One character 
is deleted for each successive pressing of RUBOUT. 


Terminates MCR. Normally used when requesting a 
program (user or system) that is to interact with the 
operator after the command is executed (e.g., RUN 
.«eMAC <ALT>). 
NOTE 
On some keyboards, the ALT key is’ labeled 
wEeoc" “ 


Causes a horizontal tab. Tab stops are set, by the 
software, at every eighth character position (e.g., 9, 
LT? 25 y 33) 

Causes a vertical tab of one line. 


Causes a form feed to the top of the next page. 
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Table 3-5 (Cont.) 
Terminal Control Conventions 


KEYS FUNCTION 


Interrupts system output to the’ terminal. Successive 
pressings of CTRL O cause output to start and stop. 
For example, if a directory listing on the terminal is 
requested and the first few lines present the desired 
information, CTRL O can suppress the printing of the 
rest of the directory. (Large TTY Handler only) * 


Causes the system to print the current terminal line. 
When errors make the line difficult to read, pressing 
CTRL R produces a clear copy. Input can continue on 
the newly-printed line (large TTY handler only). 


Cancels the current input line. The prompt (e.g., MCR> 
Or PIP>) is not printed on the next line, but the 
system is ready for the typing of a new command. 


Causes a user-written program named TTYNnn to’ execute; 
nn is the two digit unit number of the terminal with 
which the program is to interact during execution. 


These two keys correspond to XON and XOFF respectively. 

(Pressing CTRL Q (XOFF) stops output to the terminal 
until CTRL S (XON) is’ pressed. Unlike CTRL O, the 
XON/XOFF function stops and starts output without any 
loss of characters. The silo of the VT05 terminal 
generates xXON/XOFF automatically. (Large TTY Handler 
only) * 


*The system manager is responsible for installing the large fMfTyY 
handler. Installation usually is performed during system generation. 
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3.6 CARD READER CONTROL CONVENTIONS 

The card reader handler recognizes three control characters. The 
control character code identifies the alphanumeric format for either 
029 card codes or 026 card codes, or it indicates end-of-file. Table 
3-6 defines the control characters. 


Control character codes appear in column 1 of a multipunch control 
card; however, they are not transferred to the user's buffer nor 


included in the word count. 


Table 3-6 
Card Reader Control Conventions 


CARD COLUMN 1 

MULTIPUNCH MEANING 
12-11-0-1-6-7-8-9 End-of-file ASCII mode* 
12-0-2-4-6-8 029 mode 


12-2-4-8 026 mode 


NOTE 


Control Cards must enclose input data 
streams. 


*End~-of-file binary mode requires the same multipunches in card 
columns 1 to 8. 
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USER/SYSTEM INTERFACE 


4.1 MONITOR CONSOLE ROUTINE 


The Monitor Console Routine (MCR) is the terminal interface between 
the user terminal and the RSX-11D operating system. This interface is 
accomplished by means of simple MCR System Commands. 


MCR's system command repertoire enables the user to perform’ the 
following functions. 


- Gain access to the system 
- Initiate and terminate execution of user/system programs 


. Adjust, modify, and control the system environment 


4.1.1 MCR Organization 


MCR services are organized internally as a re-entrant dispatcher task 
and a set of independent system command tasks. The individual command 
tasks are called by the dispatcher task as needed and are released 
automatically after execution. 


The dispatcher portion of MCR must be active in order to receive 
requests (system commands) for MCR function tasks from the user 
terminal. 


4.1.2 Command And Slave Terminals 


User terminals consist of two distinct classes: command terminals and 
Slave terminals. 


Command terminals are used to activate MCR and thus gain access to the 
system. Once system access is established, the terminal is used to 
initiate system commands, or respond to system prompts. 


Slave terminals, on the other hand, are _ passive. They can only 
respond to or interact with user tasks. For example, a slave terminal 
might be used in a process control environment to display or print out 
data relevant to an ongoing operation; or in a data processing 
environment to communicate data to an order-entry system. 


NOTE 


Any attempt to use a designated slave 
terminal as a command terminal is 
ignored by the system. 


The classification (command or slave) of terminal use is the 
responsibility of the system manager, or another privileged user. The 
system manager can establish a terminal as being system or slave by 
issuing the SET system command. The SET command is described in 
Chapter 6. 


4.1.3 Activating MCR 


The dispatcher portion of MCR must be active in order to receive 
requests (system commands) for MCR function tasks’ from the user 
terminal. Activating MCR consists of typing CTRL C on the terminal 
keyboard. When MCR becomes active, the following prompt is issued: 


MCR> 
At this point the link between the user and MCR is established. 


If the user has not gained access to the system (i.e., logged-on), the 
only MCR system command available for use is the HELLO command (see 
Section 5.8). The HELLO command identifies the user to the- system, 
establishes the user's privileges (see Section 4.1.4), and grants the 
user access to the system. When access has been granted, the user can 
execute MCR system commands and access files consistent with his 
access privileges. 


NOTE 
The typing of CTRL C does not affect the 
execution of any tasks currently 
running. 


4.1.4 User Privileges 


The system determines user privileges by the UIC under which the’ user 
logs-on. Privileged users are assigned UICS whose group code is 10 
octal or less. Nonprivileged users are assigned UICS with group codes 
greater than 10 octal. UICS are assigned to the user by the system 
Manager. 


Two categories of users are granted access to the operating system: 
privileged and nonprivileged. 


A nonprivileged user uses the system on a day-to-day basis, but is not 
responsible for its maintenance and control. A subset of MCR system 
commands is provided for this user. These commands are described in 
Chapter 5. 


A privileged user, like a nonprivileged user, uses the system on a 
day-to-day basis, but also has responsibility for the maintenance and 
control of the operating system. This user has access to the general 
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MCR system commands described in Chapter 5 as well as_ to the 
privileged commands described in Chapter 6. 


4.1.5 Entering System Commands 


System commands are entered in response to the MCR prompt (MCR>). 
Once the prompt is issued, MCR waits for a system command to be 
entered immediately following the right angle bracket character (>). 
If the system command is not entered within a preset period of time, 
MCR times out. (See Section 4.1.6). To reactivate MCR, the user need 
only retype CTRL C. 


System commands (command lines) are entered in the following format. 


MCR>Command [command string] 


where: 
Command is the system command function to be 
performed. 
command string if required, are command modifiers or 


qualifiers. Command string formats vary from 
command to command, and for this reason, are 
individually described in their respective 
command descriptions. See User Command 
Chapters 5 and 6. 


The system command line, typed in by the terminal user, is stored by 
the MCR dispatcher. The dispatcher then initiates the corresponding 
MCR system command task and exits. The MCR system command task _ then 
interprets the command line that the dispatcher stored and performs 
the desired function. The command task executes under the UIC’ under 
which the user logged in. 


When the system command task exits, the MCR dispatcher is or is not 
reactivated depending on how the command line was terminated. If the 
command line was terminated by a RETURN, the MCR dispatcher is 
reactivated for that terminal. If the command line was terminated by 
an ALTMODE, the MCR dispatcher does not reactivate. In this case, the 
user must enter CTRL C to reactivate to MCR. 


4.1.6 MCR Timeout 


MCR waits for a specific length of time (5 minutes set at system 
generation, unless changed by the system manager) for a command to be 
entered. See the SET command in Chapter 6. If this wait time is 
exceeded, MCR times. out. At timeout, all information, since the 
previous line terminator is lost. 


When MCR times out, a carriage return occurs, and the terminal does 
not respond to commands typed in by the user. To re-establish 
communications with MCR, the user must type CTRL C. 
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4.2 TASK RUN-TIME UICS AS FUNCTION OF USER TYPE 


Table 4-1 illustrates what the UIC of an executing task will be as a 
function of how the task is initiated by a privileged or nonprivileged 
user and the state of the task prior to initiation. Also refer to 
Section 5. for non-privileged versions of run command and Section 6. 


for privileged version. 

A user can initiate a task from a terminal in any one of four ways: 
l. MCR>xyz e.g., MCR>PIP 
2. MCR>RUN ...xyZ e.g., MCR>RUN ...PIP 
3. MCR>RUN Sfile-specification e.g., MCR>RUN SEDI 


4. MCR>RUN file-specification e.g., MCR>RUN [200,200]MYTASK 


4.2.1 Error Reporting 


Errors encountered by system command tasks are reported in the form of 
error messages listed on the user terminal. Error messages consist of 
a 3~-letter command task name and two dashes (--) followed by the error 


message text. 
Example 
SYS ~~ COMMAND SYNTAX ERROR 


The RSX-11D system error messages are listed and described 
alphabetically in Appendix A.2. The only messages that do not have 
the 3-letter prefix are those issued by the task MCRERR. Section 
A.2.1 describes these messages. 


Table 4-1 
UIC of an Executing Task 


TASK ALREADY INSTALLED, BUT TO BE 
REMOVED WHEN NO ACTIVE VERSIONS TASK NOT INSTALLED 


TASK ALREADY INSTALLED 
Method 


of 
Initiation: 


Privileged 
User 


User's UIC 
Task's UIC 
User's UIC 


Task's UIC 


Nonprivileged 
User 


User's UIC 
Illegal 
User's UIC 


Illegal 


Privileged 
User 


Not applicable 
Not applicable 
User's UIC 


Task's UIC 


The user's UIC is the UIC 


Nonprivileged 
User 


Not applicable 


Not applicable 
User's UIC 


User's UIC 


NOTES 


Privileged 
User 


Not applicable 
Not applicable 
User's TIC 


Task's UIC 


specified in 


the HELLO command when the user logged 
onto the system. 


The task's UIC is the UIC specified 
during the building of the task, or when 
the task is installed, or when an 
explicit UIC is given in a RUN command. 
If no UIC is specified, the user's UIC 
becomes the task's UIC when the task is 
actually activated. 


Nonprivileged 
User 


Not applicable 
Not applicable 
User's UIC 


User's UIC 
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CHAPTER 5 


GENERAL USER COMMANDS 


The general user commands listed below are available to all users. 
Commands are presented in alphabetic order in this chapter. 


ABORT 
ACTIVE TASK LIST 
BYE 

- CONTINUE 
DISMOUNT 
HELLO 
LOG 

- LUNS 

- MOUNT 

- OPERATE 
PASSWORD 
QUEUE 

» RESUME 
RUN 

- SYS 
TIME 


WHO 


NOTE 
Please reread the Preface for 
explanation of characters (, /, [], 
etc.) that indicate command format 


conventions. 
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ABORT 


5.1 ABORT COMMAND (ABO) 
FUNCTION: 
The ABORT (ABO) command allows the terminal user to terminate the 
execution of tasks which have been initiated from that terminal. 
FORMAT: 


ABO[RT]Ataskname[,taskname,...] 


where: 


taskname is the name of the task being aborted. 


EXAMPLE: 


_MCRD>ABO ...MAC,RICK 


The above command causes the execution of the tasks named MAC and RICK 
to be terminated. 
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ACTIVE TASK LIST 


5.2 ACTIVE TASK LIST COMMAND (ACT) 


FUNCTION: 
The Active Task List (ACT) command enables the terminal user’ to 
obtain a list of the tasks active within the system, along with 
status information about the tasks. 


FORMAT: 


ACTA[({taskname] [/switch(s) ] 


where: 
taskname is the name of the task whose status information 
is to be listed. If taskname is not specified, 
all of the tasks having the same TI as_ the 
terminal from which the command is issued are 
listed. 
/switch(s) is one or more of the following switch options: 
NOTE 
If no switch is specified, the following 
information is listed for all active tasks 
having the same TI as the terminal from 
which the command was issued: 
Task Name 
Task Status (see Table 5-1) 
TI Device 
/FU specifies that a full listing of the named task's 


status information is to be generated. Use of 
this switch has the following restrictions: 


1. It can be specified only when taskname is 
specified. 


GENERAL USER COMMANDS 
It cannot be specified in conjunction with the 
/ALL switch. 


Specifying /FU causes the following 
information to be listed: 


Task Name 
Task Status (see Table 5-1) 
TI Device 
Run Priority 
Partition 
Real Memory Starting Address 
Number of Active Versions 
Requesting Task's Name 
Registers 
RS, PC, RO, R1, R2, R3, R4, R5, SP 
Event Flags 1-16 
Event Flags 17-32 
ATL Flags Word 
STD Flags Word 
Event Flag Masks 
Mark Time Count 
ATL Node Address (Kernel Virtual) 
STD Node Address (Kernel Virtual) 
Maximum Task Size 
I/O Pending Count 
I/O In Progress Count 
Pool Limit Count 
Pool Usage Count 
Global Libraries and Commons (if any) 
PARS-- 0-7 


PDRS-- 0-7 


CHARACTERS 
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Table 5-1 
ACT Task Status Characters 


DESCRIPTION 


request queued 

request unqueued 

reguest failed 

running 

AST gueued 

suspended 

waiting for 

waiting for 

waiting for 

waiting for 

waiting for 

exited 
I/O rundown required 
I/O rundown in progress 
I/O rundown finished 
I/O rundown failure 
Task termination fault 
Task termination notice requested 
Task suspended for termination notice 
Task suspended for checkpoint 
Record request queued 
Record request succeeded 
Record request failed 


Parity error 


/SH 


/ALL 


/TI=dev 


EXAMPLES: 
l. MCR>ACT 
TT.... WO TTO7 
.--ACT RN TTO7 
--PIP WO TTO7 
26 MCROACT ...PIP 


--e-PIP WO TTO7 
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Specifies that a shorter version of the /FU 
listing is required. The following information is 
listed: 

Task Name 

Task Status (see Table 5-1) 

TI Device 

Run Priority 

Partition 

Real Memory Address 
Specifies that every active task in the system is 
to be listed. Use of this switch has_- the 


following restrictions: 


1. It cannot be specified in conjunction with the 
/FU switch. 


2. It cannot be specified in conjunction with the 
/TI=dev switch. 


The following information is listed about each 
task: 


Task Name 

Task Status (see Table 5-1) 

TI Device 
Specifies that all of the tasks of a specific TI 
are to be listed. dev is the terminal identifier 
for the specified TI. The following information 
is listed about each task: 

Task Name 


Task Status (see Table 5-1) 


TI Device 
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MCR>ACT ...PIP/SH 
..-PIP WO TTO7 055 GEN 233300 
MCR>ACT ...PIP/AL/SH 


.«ePIP Wl TTO1 055 GEN 213300 
.--PIP Wl TTO2 055 GEN 244400 


MCR>ACT ...FLX/FU 


..eFLX WO TTOO 050 GEN 371000 ACT VERS 002 REQ TASK ...MCR 
REGS 174000 002510 021322 000010 027522 000006 000101 000101 
000342 

EV 1-16 000000 EV 17-32 140000 ATL FLGS 000200 STD FLGS 060100 

EV MASKS 000002 000003 040647 030040 MKTM CNT 000 

ATL ADDR 107000 STD ADDR 103700 TSK SIZE 063700 

I/O PEND 003 I/O PROG 001 POOL LIM 040 POOL USE 014 > 

GBLS SYSRES 

PARS 003720 004120 004320 004520 000000 000000 000000 001747 

PDRS 077606 077606 077606 013206 000000 000000 000000 071502 


MCR>ACT /ALL 


DP.... WO TTOO 
TT.... WO TT10 
DK.... WO TTOO 
LP.... WO TTOO 
DF.... WO TTOO 
DT.... WO TTOO 
MT.... WO TTOO 


.«-MCR WO TT10 
».eACT WO TTO7 
MO.... WO TTO5 
..-TKB RN TTOO 


MCR>ACT /TI=TT10 


TT.... WO TT10 
.--MCR WO TT10 


MCR>ACT ...PIP/TI=TT2/FU 


-+-PIP Wl TTO02 055 GEN 213300 ACT VERS 001 REQ TASK ...MCR 
REGS 174004 167762 004644 013522 000000 006003 000040 013710 
000236 

EV 1-16 000000 EV 17-32 040000 ATL FLGS 000200 STD FLGS 020100 

EV MASKS 100000 000256 000401 000002 MKTM CNT 000 

ATL ADDR 106300 STD ADDR 100660 TSK SIZE RO 007300 RW 021600 

I/O PEND 002 I/O PROG 000 POOL LIM 040 POOL USE 003 

PARS 002143 002351 002306 000000 000000 000000 000000 001747 

FDRS 061206 035102 021206 000000 000000 000000 000000 071502 
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BYE 


5.3 BYE COMMAND (BYE) 


FUNCTION: 


The BYE command provides the user with a facility for logging-off 


a terminal. The only command MCR recognizes after this command 
is executed is HELLO. The BYE command has no effect 


on active 
tasks previously initiated from this terminal. 


FORMAT: 


BYE. 


EXAMPLE: 


MCR>BYE 
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COMMON BLOCKS 


5.4 LIST COMMON BLOCKS COMMAND (COM) 


Refer to the SYS /COM command in Section 5.18. 
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CONTINUE 


5.5 CONTINUE COMMAND (CON) 


FUNCTION: 
The CONTINUE Command (CON) is used to continue the execution of a 
task that as selected the SUSPEND action parameter option when 
using the message output handler task. 


FORMAT: 


CON[TINUE]Ataskname[,taskname,...] 


EXAMPLES: 

MCR>CON XKE 

MCR>CONTINUE XKE,NK111 
In the examples above the respective reguests are to: 
1. Continue task XKE. 


2 Continue task XKE and task NKl1ll. 
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DEVICES 


5.6 DEVICES COMMAND (DEV) 


Refer to the SYS /DEV command in Section 5.18. 
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DISMOUNT 


5.7 DISMOUNT VOLUME COMMAND (DMO) 


FUNCTION: 


The Dismount Volume (DMO) command allows the user to _ logically 
dismount (make invisible to the system) a previously mounted 
volume. DMO deletes the Volume Control Block (VCB) and its 
extensions, thus declaring the volume to be logically off-line, 
and rendering it inaccessible. 


Before shutting down an RSX-11D system, all volumes’ should be 
logically dismounted to ensure that no files are currently being 


accessed. Any files currently being accessed when the system is 
shut down may contain inconsistent data. 


Tf the volume contains files currently being accessed, the 
following message is issued, and the dismount operation is 
aborted: 
DMO -- VOLUME BUSY. TRY AGAIN LATER 
FORMAT: 


DMOAdev: [volumelabel] [/UIC=[uic] ] [/LOCK] 


where: 

dev: is the device specifier for the device on which the 
volume is mounted. 

volumelabel 
is label of the volume being dismounted. If specified, 
the value entered is compared with the corresponding 
value in the VCB. Tf unegual, the volume is not 
dismounted. 

/UIC=[uic] 
is the volume UIC. Like the volume label, it is 
compared to its corresponding entry in the VCB. If 
unequal, the volume is not dismounted. 

/ LOCK If this option is specified, the volume is marked _ for 


dismount regardless of whether files are currently 
accessed on it. Further accesses are then disallowed 
and the volume is actually dismounted only when all 
current file accesses are terminated. 


If the DMO command is issued for any volume of a multivolume magnetic 
tape file, all of the mounted volumes are automatically dismounted. 
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The following message is issued by the file processor when the logical 
dismount is completed and it is safe to physically remove the volume 
from the system: 


FI1ACP - ~ DKO: ** DISMOUNT COMPLETE ** 


The first six characters of the message (FI1ACP) are the. task name of 
the file processor, and may vary with the device and the manner in 
which it was mounted. 


EXAMPLES: 


Ls MCR>DMO DK1: 


In this example, the VCB for the volume mounted on DkKI: is 
deleted, and the volume becomes inaccessible. 


2. | MCR>DMO DK1:RICKSVOL/UIC=[300;300] 


In this example, the VCB for the volume mounted on ODkKl: is 
interrogated. If it contains a volume label of "RICKSVOL" and a 
UIC of “[300,300]", the VCB is deleted, and the volume becomes 
inaccessible; otherwise, the volume remains mounted. 


3:3 MCR>DMO MT1:VOLUM1 


In this example, the VCB for the volume mounted on MTIl: is 
interrogated. If it contains a volume label of VOLUM1 the VCB is 
deleted; otherwise the volume remains mounted. 


If the specified volume is one of a multivolume magnetic tape file, 
all of the mounted volumes of the file are automatically dismounted. 
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5.8 HELLO COMMAND (HEL) 


FUNCTION: 


The HELLO command (HEL) allows the user to log 
and be 


Section 4.1.4.) 


FORMAT: 


HEL[LOJA [uic] 


EXAMPLES: 


NOTES 


If the user-entered [UIC] (brackets 
required) does not have a corresponding 
UFD on the system device (SY:), system 
access is denied and the following 
message is issued: 


HEL ~- CANNOT FIND DIRECTORY FILE 


Tf the UFD is password-protected, the 
following prompt is issued: 


PASSWORD> 


The user must enter the correct password 
immediately following the prompt. (The 
user-entered password does not print on 
the terminal.) 


Tf the user-entered password is in 
error, system access is denied and the 
following message is issued: 


HEL ~~ ILLEGAL PASSWORD 


onto 
identified as a valid user by the system. It also 
identifies the user as a general or privileged 


HELLO 


a terminal 


user. (See 


A The log-on procedure for a nonpassword-protected UIC is: 


MCR>HELLO [200,200] 
MCR> 
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2s The log-on procedure for a password-protected UIC is: 
MCR>HELLO [200,200] 


PASSWORD> 
MCR> 


NOTE 


The password entered by the user is not 
printed on the terminal. 
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LOG 


5.9 LOG COMMAND 
FUNCTION: 


The LOG command allows the user to type a comment on _ the 
terminal. This feature can be used to note information about the 


current system. Data typed following this command has no effect 
on the system. . 


~ FORMAT: 
LOGA comment-line 
or 
sA comment-line 
or 
1A comment-line 
EXAMPLE: 


MCR>LOG STANDARDS CHANGED BY 20 MG. PER CUP. 
Or 

MCR>; STANDARDS CHANGED BY 20MG. PER CUP. 
Or 

MCR>! STANDARDS CHANGED BY 20MG. PER CUP. 


NOTE 


A log message can fill an entire line. 
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LUNS 


5.10 LOGICAL UNIT NUMBERS COMMAND (LUNS) 

FUNCTION: 
The Logical Unit Numbers (LUNS) command lists, on the user's 
terminal, the physical device units and corresponding logical 
unit numbers for an indicated task or tasks. This command is 
used when the operator wants to determine which physical devices 
a task requires. 

FORMAT: 


LUN[S]JAtaskname[,taskname,...] 


EXAMPLE: 
MCR>LUN ...SYS 
BERR Swe LO 
Trt 2 
TTO 6 
CLO 5 
LPO 3 
SY0 1,4 
TECHNICAL NOTES: 
The LUNS command lists: 
l. 1/0 assignments taken from the task's disk image 


2. Only the devices to which assignments have been made 


Any run-time changes in LUN assignments made by an active task are not 
reflected in the listing. 
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MOUNT 


5.11 MOUNT COMMAND (MOU) 
FUNCTION: 


The MOUNT command (MOU) allows the user to make a selected volume 
visible to the system. MOU creates the Volume Control Block 
(VCB) and declares that the volume is logically on-line for 
access by the File Control Primitives. 


FORMAT: 
The format listed below is the general format for the MOUNT 
command. MCUNT for multivolume magnetic tape is somewhat 
different in format, and is discussed in section 5.11.1. 


MOU [NT]JAdev:volumelabel [keyword (s) ] 


where: 
dev: is the device specifier for the device that contains the 
volume being mounted. 
volumelabel 


is the volume label of the volume being mounted. The 
label specified is compared to the label field of the 
volume's home block, to ensure that the physically 
mounted volume is the one to be logically mounted (made 
visible) by the system. 


NOTE 


Disk and DECtape volumes are allowed to contain 
null (all zeros) volume labels. In this case, 
the volume label need not be specified. The 
system assumes a null label. 


/keyword(s) 
are optional modifiers that allow the user to. override 
the volume characteristics that were assigned to the 
volume when it was initialized. The following keyword 


options are provided. 


* 
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NOTE 


Notations listed to the left of keyword options 
equate to the following: 


* Applies to disk and 
DECtape only 


= Overrides the corresponding 
option specified at INITVOL 


+ Applies to magnetic tape only 
/CHA=[characteristic word] 
This option changes the device characteristic 


word. Possible parameters for this option are: 


e+ FOR -not an RSX-11D structured volune 

(FOREIGN). When this parameter is 
specified DCF is automatically 
assumed. 

ATCH -device may be attached for 
exclusive use by one task. 

DCF -device control functions permitted; 
removes restrictions. 


NOTE 
ATCH and DCF are legal for magnetic tape 
only when it is mounted as FOREIGN. 
Example 
/CHA=[FOR,ATCH] 
/UNL 


This option specifies that the volume's index file is to 


be left unlocked, thus giving tasks write access to the 
index file. 


/DENS=magnetic tape density 
Possible parameters are: 
800 for 800 BPI 


1600 for 1600 BPI 
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Example 
/ DENS=800 
/ACP=task name 


This option allows the user to designate the task 
is to be the file processor for the volume. 


Example 
/ACP=DSKFI 
/EXT=default file extend increment in blocks 
Example 
/EXT=5 
/FPRO=[default file protection] 


This option allows the user to change the default 


that 


file 


protection assigned to new files created on the volume. 


Each entry consists of from one to four letters 
have the following meanings. 


R - for READ access 

W - for WRITE access 
E - for EXTEND access 
D ~ for DELETE access 


The absence of one of these letters in an 
Signifies the access right is denied to the user. 


which 


entry 


Protection code subparameters (system,owner ,group,world) 
are positional; therefore, the location of entry in the 


parameter string defines the user to whom the 
apply. 


Example 


/FPRO=[RWED,RWED,RW, RW] 


In this example, group and world are denied Extend 


Delete access. 

/LRU=number of directories to keep pre-accessed 
Example 
/ URU=3 


/OVRFSID 


codes 


and 


This option is used to override the set identifier 
check. This option is required when processing magnetic 


tape with inconsistent file set identifiers. 


GENERAL USER COMMANDS 


/OVREXP 


This option is used to override the expiration date 
check. Allows the user to overwrite unexpired magnetic 
tape files. 


5.11.1 Format For Mounting Multivolume Magnetic Tape 


The following format should be used to mount multivolume magnetic 


tape. 


MCU [NT]JAMT(nl[,n2,...,nn]):(labell[,label2,...,labeln] 


where: 


label 


[/keyword(s) ] 


is the logical tape drive number(s) (in the order of 
selection) representing the drive(s) to be dedicated to 


the processing of the multivolume set. If only one 
drive is being dedicated, the parentheses may be 
omitted. 


is the volume label(s) (in order) that constitute the 
volume-set. Only the volume label for the first volume 
in the set need be specified. If further labels are 
specified, they will be used by the file processor to 
validate further volumes as they are requested. Tf no 
further labels are specified, it is up to the user to 
ensure that the correct volume is placed on the 
appropriate drive when requested. 


NOTE 


A separate unit number need not be specified for 
each volume in the set. The file processor 
processes volumes sequentially down the list of 
specified units, until the last unit is reached. 
Tf more volumes are to be processed, a mount 
request, for the next sequential volume to be 
mounted is issued for one of the units listed. 


/keyword (s) 


See keywords provided for the general class of Mount 
command. 
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TECHNICAL NOTES: 


Because of the large number of options available with the MOU 
command, it may not be possible to enter the entire command 
string on a single line. For this reason, MOU has been modified 
to accept multiline commands. To accomplish this, the user must 
follow the procedure outlined below. 


1. Initiate MOU as follows: 
MCR>MOU 


When MOU is ready to accept command lines, issue the 
following prompt: 


MOU> 


2. At this point, multiple lines can be typed in to MOU. Each 
line except the last must contain a hyphen (~-) as the last 
character entered. When MOU recognizes the hyphen, it 
assumes that the command line is incomplete, and reissues the 
MOCU> prompt for more parameters. When the last line is 
entered (no hyphen), MOU begins processing the command. See 
example number 3. 


EXAMPLES: 


1. 


MCR>MOUNT DK1:SYS004 


In this example, a request is made to mount disk volume SYS004 on 
DKl:. None of the volume's attributes are to be overridden. 


MCR>MOU MT(1,2): (RICK,SHEILA, LAURA, JEN) 


In this example, a request is made to mount multivolume magnetic 
tape. Logical tape units 1 and 2 are reserved for processing. 
At the time the mount reguest is being processed, tape volume 
RICK must be physically mounted on logical tape unit 1; 
otherwise, the label check will fail. No label check is made for 
tape unit 2 until the file processor is ready to process the next 
volume (SHEILA). 


MCR>MOU 
MOU>DK1:ACCTSYS/WIN=10.- 


MOU>/LRU=4/FPRO=[R,RWED,R,] 
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OPERATE 


5.12 OPERATE COMMAND (OPR) 


FUNCTION: 


The OPERATE (OPR) command enables the terminal user to direct the 
output processing of the Multi-Output Despooler. See Section 
2.6. 


FORMAT: 
OPR[ATE]JA dev:/switch[,dev:/switch,...] 
where: 


dev: is the device specifier for the Multi-Output Despooler 
device being controlled. 


/switch is the command modifier that directs OPR operation. 
OPR switches are described in Table 5-2. 
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Table 5-2 
OPR Switches 


SWITCH DESCRIPTION 


Start printing, on the specified device, all files 
whose forms-type match the forms-type currently 
specified for this device. 


Abort printing of the current file on the specified 
device. Select the next eligible file for processing. 


NOTE 


Although the aborted file is removed from_ the 
queue, it is not deleted. Therefore it is still 
available and can be requeued for printing at some 
later time. 


Stop printing of the current file on the specified 
device. Printing of the file is stopped in place. 
Printing can be resumed by specifying one of the /RS 
switches; or it can be aborted by specifying the /AB 
switch. 


/RS Resume printing of the current file on the specified 
device. 


/RS:T Resume printing of the current file from the last 
encountered form feed. If no previous form feed was 
encountered, printing begins at the top of the file. 


/RS: TOF Restart printing of the current file from the 
beginning. 


NOTE 


All of the /RS options can be used without a 
previous stop option having been issued. 


EXAMPLES: 
1. MCR>OPR TT1:/ST 


In this example, the user has directed that the printing of files 
on TTl: be suspended. 


2% MCR>OPR TT1:/RS: TOF 


In this example, the user has directed that the printing on fTTl: 
be resumed, and that the file be reprinted from the beginning. 
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PARTITIONS 


5.13 PARTITIONS COMMAND (PAR) 


Refer to the SYS /PAR command in Section 5.18. 
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PASSWORD 


5.14 PASSWORD COMMAND (PWD) 


FUNCTION: 


The PASSWORD Command (PWD) allows the terminal user to change or 


create a password for his UFD on the system disk. 


FORMAT: 
PWDA[ufd] 
wheres: 


[ufd] is the UFD receiving the new password. 


When the above command is received by PWD, the following 


prompting message is issued. 


PASSWORD> 


The user now enters the desired password immediately following 
the right angle bracket (>). The newly entered password is not 


typed on the terminal. 
NOTE 
Only the UFD which corresponds to the 


UIC under which the user logged on can 
be changed. 


EXAMPLE: 


MCR>PWD [200,200] 
PASSWORD> 


MCR> 
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QUEUE 


5.15 QUEUE COMMAND (QUE) 

FUNCTION: 
The QUEUE command (QUE) is the terminal user's interface to the 
RSX-11D queue manager task. The Queue Manager maintains a queue 
of elements. Each element defines a Files-ll file specification 
for a file that is to be printed on a line printer or a terminal. 


The QUE command provides the user with the ability to perform the 
following functions: 


1. Print queue files on a line printer or terminal. 


2. List user-related elements in the queue manager task's 
queue. 


3. List all elements in the queue manager task's queue. 


4. Kill (delete) user-related element(s) in the gueue 
Manager task's queue. 


5. Modify user-related element(s) in the queue manager 
task's queue. 
NOTE 
QUE works only with the Multi-Unit 
Spooler. 
FORMAT: 
The format of the QUE command varies depending on the function 


being performed. The format for each function is described in 
its respective section. 
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5.15.1 Queue A File For Printing 


This function of the QUE command allows the user to gueue ae file 
files for printing on a line printer or terminal. 


FORMAT: 


QUEA[dev:=]infile-l[,infile-2,...,infile-n] [/switch(es) ] 


or 
QUE @indirect 
where: 
dev:= is the optional listing device specifier (default 
LP:). 
infile is a file specifier for the file(s) being queued 


Or 


is 


for 


printing. (See Table 5-3 for a list of defaults in QUE 


file specifiers.) 


NOTE 


QUE allows wildcard specifiers. 


/switch is one or more of the QUE option switches. 
(es) (See Table 5-4). QUE option switches are global; 


that 


is, they may be specified once for an entire list of 


input file specifiers. They may be appended to any 


of 


the file specifiers in a list. However, if a switch is 
specified repeatedly, the last value specified is used. 


@indirect is an indirect command file specifier. 


NOTE 


The QUE function supports three levels of 
indirection. 
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Table 5-3 
Defaults in QUE File Specifiers 


SY: 


For the first or only file specifier, 
the UFD which corresponds’ to the UIC 
under which the user logs on. 


For the second through n file 
specifiers, the UFD specified or 
defaulted for the previous file 
specifier. 


filename Must be specified. 


. type .LST 


sver The latest version for the file. 
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Table 5-4 
QUE Command Optional Switches 


SWITCH DESCRIPTION DEFAULT 


Set the priority of output selection to 
nnn (nnn is a decimal number ranging 
from 1 to 250). 


Set the output forms type to n (n is 
decimal number ranging from 0 to 6). 


Specific form types are defined by the 
system manager; for example, form type 

0 should correspond to standard line 
printer forms (single ply, 11" x 15"); 
form type 2 could correspond to payroll 
check forms; form type 3 could correspond 
to standard billing forms. 


/CO:nn Set the number of copies to be printed to 
nn (nn is a decimal number ranging 
from 1 to 31). 


/DE Delete the input file after it has been 
spooled. 


Test for forms alignment. This switch 
is used to ensure that the desired 
forms are properly aligned in the 
receiving device. 


The priority entry is automatically 
set to 250, and the forms type entry 
is set to 7. 


This option, although documented in this 
chapter, is normally used by the system 

Manager; it is also normally preceded by 
the following privileged MCR system com- 
mand: 


MCR>OPR LP:/CH 
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EXAMPLES : 


1. 


MCR>QUE TEST 


In this example, the latest version of file TEST.LST, residing in 
the user's directory file on SY:, is queued for printing. The 
following options are assigned to the queued entry. 


~ Printing device LP: (default) 
~ Priority 50 (default) 
~ Forms type 0 (default) 
~ Number of copies 1 (default) 
- Delete No (default) 


MCR>QUE TT1:=TEST.MAC/PR: 250/CO:4/DE 


In this example, the latest version of file TEST.MAC, residing in 
the user's directory file on SY:, is queued for printing. The 
following options are assigned to the queued entry. 


- Printing device TELS 

~ Priority 250 

~ Forms type 0 (default) 
~ Number of copies 4 

- Delete Yes 


MCR>QUE [20,20] TEST,DK1:TEST.MAC,TEST.CMD/PR: 250 


In this example, the latest version of the file TEST.LST, 
residing in the directory file [20,20] on SY:, and the latest 
version of files TEST.MAC and TEST.CMD, residing in directory 
file [20,20] on DKl:, are queued for printing. The following 
options are assigned to each file entry. 


~ Printing device LP: (default) 
- Priority 250 

- Forms type 0 (default) 

~ Number of copies 1 (default) 

~ Delete No (default) 
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4. MCR>QUE [202,12]*.MAC 


In this example, the latest version of all files of the type MAC 
residing in directory file [202,12] on SY:, are queued for 
printing. The following options are assigned to the aueued 
entries. 


~ Printing device LP: (default) 
~ Priority 50 (default) 
~ Forms type 0 (default) 

~ number of copies 1 (default) 

~ Delete No (default) 


5.15.2 List Elements In Queue (/LI) 


The list function (/LI) of the QUE command allows the user to obtain a 
listing of all entries in the queue manager task's queue. Output from 
this function provides the user with pertinent information concerning 
the status of each entry in the queue, as well as the options 
specified for each entry. A sample queue listing, along with a 
description of the information it provides, is contained in Figure 
SLs 


ACT ACCOUNT FILE SPECIFICATION SEQ PRI 


[200,200] DPO:TEST.LST;6 100 
[200,200] DK1:RSXMAC.SML;17 4 240 
[200,200] DKO:TEST.MAC; 40 2 20 
[200,200] DPO0:QUE.CMD;3 3 50 


DEV/A= Destination device. 


ACT Asterisk denotes an input file which is currently 
being output by the Despooler. 


ACCOUNT UIC of user who queued the request. 


FILE SPECIFI 
CATION Input file specification 


SEC Seguence number that uniquely identifies an 
inactive queued entry. 


PRI Priority of output selection. 
FO The forms types. 
co Number of printed copies. 
Delete/Preserve indicator. An asterisk indicates 


the file is to be preserved after output is 
complete. 


Figure 5-1 
Sample Output from QUE /LI Function 


S32 
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FORMAT: 
QUEA/LI 
EXAMPLE: 


MCR>QUE /LI 


DEV ACT ACCOUNT FILE SPECIFICATION SEG PRI FO CO P 

LPO * [200,200] DPO:TEST.LST;6 100 0O 4 x 
TT5 [200,200] DK1:RSXMAC.SML;17 4 240 0 1 x 
TT1l [200,200] DKO:TEST.MAC; 40 2 20 0 1 

TT5 [200,200] DPO:QUE.CMD;3 3 50 0 1 


5.15.3 List All Elements in Queue (/AL) 


The list all (/AL) performs the same function as list (LI) except that 
all entries in the queue are printed regardless of the user's UIC. 


5.15.4 Kill (Delete) Elements in Cueue (/KT) 


The kill function (/KI) allows the user to delete elements from_ the 
queue manager task's queue. The user accomplishes this deletion by 
specifying the entry's queue sequence number as a parameter to the /KI 
function. Cueue entry sequence numbers can be obtained by executing 
the QUE command with the /LI function specified. 


NOTE 


Any attempt to delete a queued entry 
with an account number that is not the 
user's results in a privilege violation 
error message. 


FORMAT: 
QUEA/KI:seq[:segq:...:seg] 
where: 
:seq is the sequence number for the queued entry being 
deleted. 
Two formats for specifying sequence numbers are supported: a single 


defined sequence number (:seq) or a range of sequence numbers 
(:seql-segn). 
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A single defined sequence numbers is specified by entering a colon (:) 


followed by the 


entry. 


sequence 
sequence number is interpreted as a command to delete a single 


number. 


A range of sequence numbers is specified by entering a colon 


the beginning 
sequence number. 


interpreted as a 
sequence numbers start with the number specified to the 


command to 


the seguence 


format is used, the 


queued 


(:) and 
seguence number, followed by a dash (-) and the ending 

When this format is used, 
delete 


numbers are 
all entries whose consecutive 
left 


of the 


dash and end with the number specified to the right of the dash. 


Any combination of formats can be used in the same /KI 


however, the 


maximum 


Figure 5-2 for a sample execution of the /KI function. 


DEV ACT ACCOUNT 


LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 


FILE SPECIFICATION 


DPO:RCVAST.MAC; 45 
DPO0:SETBLD.CMD; 3 
DPO:PRTX.MAC;3 
DPO:PRT.MSG; 3 
DPO0:OPR.MAC;17 
DP0:OPRBLD.CMD;5 
DPO:SET.MAC;11 
DPO:MAC12.CMD;4 
DPO0:SPRODT.CMD;2 
DPO:INLINE.MAC;51 
DP0:FORMAT.MAC; 23 
DPO:SETUP.MAC;15 
DPO: IOAST.MAC;25 
DP0:SPR2.MAC;60 
DP0:SPRBLD.CMD;10 
DPO:TSTBLD.CMD;6 
DPO0:TEST.MAC;22 


QUE>/KI:27-30:1:3-5:7-8:13 
QUE>/LI 


CEV ACT ACCOUNT 


LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 


FILE SPECIFICATION 


DP0:RCVAST.MAC; 45 
DPO0:SETBLD.CMD;3 
DP0:SPR2.MAC;60 
DP0:SPRBLD.CMD;10 
DPO0:TSTBLD.CMD;6 
DPO:TEST.MAC; 22 


Figure 5-2 
Sample Execution of /KI Function 


55 
55 
55 
55 
55 
ss B) 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 


PRI FO 


BPH EEE EH HEH PRP NNNND 


command 
number of individual combinations is ten. See 


QO 
eo) 
rg 


Pt fet ee ee 


Ci i ee 


line; 


Listing of 
queued en- 


tires before 
execution of 
/KI function 


Listing of 
queued en- 
tries after 


execution of 
/KI function 


GENERAL USER COMMANDS 


EXAMPLES: 
as MCR>QUE /KI:2:6:10:12 


In this example, the queued entries whose sequence numbers are 2, 
6, 10, and 12 are deleted from the queue manager task's queue. 


Zs MCR>QUE /KI:2:6-12:14 


In this example, the gueued entry 2, the entries 6 through 12, 
and entry 14 are deleted from the queue manager task's queue. 


5.15.5 Modify A Queue Entry (/MO) 


The modify function (/MO) allows the user to change the option(s) 
Originally specified for a queued entry or entries. 


The following queued entry fields can be modified by the /MO function. 
listing device 
priority 
forms type 
number of copies 
delete option 
FORMAT: 


CUEA[dev:=]/MO:seq[:seq...:seq] [/switch (es) ] 


where: 
dev: is the new listing device specifier. If dev: is 
specified, it must be followed by an equal sign (=). 
:seq is the sequence number of the queue entry being 


modified. Sequence numbers can be entered individually 
or in a range of seguence numbers. See Section 5.15.3. 


NOTE 


When the /MO- function is executed, the 
specified gqueue entry is deleted and replaced 
with a modified version of the original entry. 
Therefore, the original sequence number 
disappears and is replaced with a number one 
greater than the highest number in the gueue at 
the time the modify function is executed. 
Figures 5-3 and 5-4 contain sample executions 
of the /MO function. 


GENERAL USER COMMANDS 


/switch(es) 
is the option modification switch(es). Modification 
switches are described in Table 5-5. 


Modification switches can be appended only to the last 
sequence number in the command line. 


NOTE 


If the /DE switch is not specified, /-DE is 
assumed. 


Table 5-5 
7MO Option Switches 


SWITCH DESCRIPTION DEFAULT 


Change the priority of the queued 
entry to nnn (where nnn is a deci- 
mal number ranging from 1 to 250). 


Change the form type to n (where 
n is a decimal number ranging from 


1 to 6). 


Change the number of copies to nn 
(where nn is a decimal number rang- 
ing from 1 to 31). 


Change the delete/preserve indica- 
tor to delete. 


GENERAL USER COMMANDS 


QUE /LI 


DEV ACT ACCOUNT FILE SPECIFICATION 


Q 
o) 
rg 


LPO [200,200] DPO:BPR.ODL;7 
LPO [200,200] DPO:RICK.MAC;14 
LPO [200,200] DPO:BPRBLD.CMD; 20 
LPO {200,200} DPO:INIT.MAC;37 
LPO [200,200] DPO:TEMP.SAV;2 
LPO [200,200} DPO:HANK.BIS;1 
LPO [200,200] DP0O:BPRMAC.MAC;5 
LPO [200,200] DPO:UTIL.MAC;3 
LPO [200,200] DPO:ERRMES.MAC;4 
LPO [200,200] DPO:MAIN. MAC; 32 
LPO [200,200] DPO:MAIN.MAC: 32 
LPO {200,200} LPO:CLOSE.MAC;12 


Listing of 
queued en- 
tries prior 
to execu- 
tion of /MO 
function 


WODNHDUAWNHH 
COCO OCCCCCOCOCSO 
ees 
+ eee eH HH HF OH OH F 


MCR>QUE TT1:=/MO: 2:6:9-12/FO: 2/PR:55/DE 
MCR>QUE /LI 


DEV ACT ACCOUNT FILE SPECIFICATION 


y 
(@) 
Q 
oO 


TT] [200,200] DPO:RICK.MAC;14 
TT1 [200,200] DPO:HANK.BIS;:1 
TTT [200,200] DPO:ERRMES.MAC;4 
TT] [200,200] DPO:LOGGER.MAC; 3 
oe [200,200] DPO:MAIN.MAC; 32 
TT1 [200,200] DPO:CLOSE.MAC;12 
LPO [200,200] DPO:BPR.ODL;7 
LPO [200,200] DPO:BPRBLD.CMD; 20 
LPO [200,200] DPO: INIT.MAC; 37 
LPO [200,200] FPO: TEMP. SAV; 2 
LPO [200,200] DPO0:BPRMAC.MAC;5 
LPO [200,200] DPO:UTIL.MAC;3 


Listing of 
queued en- 
tires after 
execution 
of /MO 
function 


DODDDOONNNNNDN 
be ee 


MCR> 


NOTE 


Note that the sequence numbers’ for’ the 
entries being modified were deleted and 
replaced with modified entries having 
new sequence numbers. 


Figure 5-3 
Sample Execution of /MO Function 
(with Option Switches Specified) 


QUE /LI 


DEV ACT ACCOUNT 


TT1l [200,200] 
TTl [200,200] 
TTL [200,200] 
TT1l [200,200] 
TT1l [200,200] 
TTl [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 


MCR>QUE /MO:13-18 
MCR>QUE /LI 


DEV ACT ACCOUNT 


TT1l [200,200] 
TT1l [200,200] 
TTl [200,200] 
TTl [200,200] 
TT1l [200,200] 
TT1l [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
LPO [200,200] 
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FILE SPECIFICATION 


DPO:RICK.MAC;14 
DP0:HANK.BIS;1 
DPO:ERRMES.MAC;4 
DP0: LOGGER. MAC; 3 
DPO:MAIN.MAC;32 
DPO:CLOSE.MAC;12 
DPO:BPR.ODL;7 
DPO:BPRBLD.CMD; 20 
DPO: INIT.MAC; 37 
DPO:TEMP.SAV;2 
DP0:BPRMAC.MAC;5 
DPO:UTIL.MAC;3 


FILE SPECIFICATION 


DPO:RICK.MAC;14 
LPO:HANK.BIS;1 
DPO: ERRMES.MAC;4 
DP0O: LOGGER. MAC;3 
LPO:MAIN. MAC; 32 
DPO0:CLOSE.MAC;12 
DPO:BPR.ODL;7 
DPO0:BPRBLD.CMD; 20 
DPO:INIT.MAC;37 
DPO:TEMP.SAV;2 
DP0:DPRMAC.MAC;5 
DPO:UTIL.MAC;3 


NOTE 


Note that the sequence 


Figure 5-3, 


with new ones. Note 


delete 
were automatically changed 


(/~-DE) 


Figure 5-4 
Sample Execution of /MO Function 
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Listing of 
queued en- 
tries prior 
to execu- 
tion of /MO 
function 


Listing of 
queued en- 
tries after 
execution 
of /MO 

function 
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RESUME 


5.16 RESUME COMMAND (RES) 


FUNCTION: 


The RESUME 
previously 


command allows the user to continue execution of a 
suspended task or _ tasks. Suspended tasks can be 


resumed only from the terminal from which they were initiated. 


FORMAT: 

RES [UMEJAt 
where: 

taskname 


/TI=dev 


EXAMPLES: 


askname [/TI=dev] [,taskname-1[/TI=dev],...] 


is the name of the task being resumed. 


is an optional switch (appended to the taskname) which 
allows the user to resume any task in the system by 
specifying its TI (dev is the device mnemonic for’ the 
terminal corresponding to the TI under which the task 
is run). 


1. MCR>RESUME XKE 


2. MCR>RESUME XKE, NK111,2402 


In the examples above the requests are to: 


1. RESUME Task XKE. 


2. RESUME Task XKE, Task NK1l11, and Task 2402. 


GENERAL USER COMMANDS 


RUN 


5.17 RUN COMMAND (RUN) 
FUNCTION: 


The RUN command allows the user to initiate task images (output 
from the RSX-11D Task Builder) that have not been installed. RUN 
causes a selected task image to be installed temporarily, loaded 
and executed and removed upon termination. 


The task attributes are those specified at task build time. The 
only exception is the task name, which is converted to the first 
six characters of the filename. 


The task runs under the UIC that the terminal is logged in under. 
FORMAT: 

RUNAfilename[/TIM=Nx] (S) 

RUNA$ filename () 


where: 


filename is the file specifier for the task image. Table 5-6 
contains a list of defaults in task image file 
specifiers. 


$filename instructs the system that the requested task image 


resides in a predetermined UFD. This UFD is defined by 
the system manager at system generation time. 


Table 5-6 
Defaults in Task Image File Specifiers 
SPECIFIER DEFAULT 
dev: SY: 
[ufd] UFD that corresponds to the UIC under which the user 


logged on 


filename Must be specified 


.- type - TSK 


sver The latest version for the file 


GENERAL USER COMMANDS 


OPTION 
/TIM=nx 
n is a decimal number indicating the number of time units 
(x) of central processor time that the task is allowed. 
x indicates the type of time unit and can be one of the 


following. 


H = hour 

M = minutes 
S = seconds 
T = ticks 


The amount of time specified must be no greater than 24 hours. 
For example, 24H, 1440M, and 86400S are the maximum amounts for 
hours, minutes, and seconds, respectively. 


If /TIM is not included and accounting is specified for the task, 
the maximum amount of processor time allowed is five minutes. If 
the task is still running after five minutes of processor’ time 
has been used and /TIM was not specified, the system aborts the 


task. 
EXAMPLE: 
MCR>RUN DK1:RICK.TSK;3() 
In this example, task image RICK.TSK;3 is installed, loaded and 


executed, and removed upon termination. RICK.TSK;3 resides in 
the user's directory file on DKl:. 


GENERAL USER COMMANDS 


5.18 SYSTEM STATUS COMMAND (SYS) 
The system status command (SYS) lists on the terminal the names of 
tasks associated with any one or all of the following system lists and 
queues. 

- Active task list (ATL) 

- Memory required list (MRL) 

- Clock queue (CKQ) 

- Global common directory (GCD) 

- Checkpointable task list (CTL) 

. I/O request queue (IRQ) 

. Fixed task list (FTL) 

- System task directory (STD) 

- Physical unit directory (PUD) 

- Task partition directory (TPD) 

- SEND/RECEIVE queue (SRQ) 

- Asynchronous system trap queue (ASQ) 
For each list, SYS prints the list name and the names of all tasks 
that have entries or are entered in that list. In the case of the SRQ 
and ASQ, SYS prints the queue name and the names of all tasks’ that 
have nodes in that queue. The function and content of system lists 
and queues are described in the RSX-11D Executive Reference Manual. 
SYS can also print the names of shared global areas (SGAs) to which 
tasks in the system task directory (STD) are bound and provide’ the 
following information: 

1. List all installed tasks. 

2. List the device known to the system. 

3. List the partition defined at system generation. 
Each list contains information related to the specific category. 
FORMAT 

SYS [/switch[:opt]] 


wheres: 


switch = any one of the valid switches listed in Table 5-7. /BRF 
is the default switch. 


opt = a partition name if /MRL or /CTL is specified, or a 
device name and unit number if /IRQ is specified. No 
colon follows the unit number. 


GENERAL USER COMMANDS 


Table 5-7 
SYS Switches 


SWITCH FUNCTION 


/ATL Lists the names of tasks in the active task list. 


/MRL[:opt] Lists the names of tasks in the memory reguired 
list. If the output from SYS is to be restricted 
to a particular partition, use the opt parameter; 
for example, /MRL:GEN indicates that the names of 
tasks installed in the GEN partition and contained 
in the MRL are to be printed. 


/CKQ Lists the names of tasks in the clock queue. 


/GCD Lists the names of libraries and common areas’ in 
the global common directory. 


/IRQ[:opt] Lists the names of tasks with entries in the I/O 
request queues. If the IRQ for a particular 
device is desired, the opt parameter must be 
included to designate the device; for example, 
/IRQ:DKO causes the IRQ associated with the DK 
handler to be listed. 


/CTL[:opt] Lists the names of tasks in the checkpointable 
task list. If the output from SYS is to be 
restricted to a particular partition, use the opt 
parameter; for example, /CTL:GEN indicates that 
the names of tasks running in the GEN partition 
and contained in the CTL are to be printed. 


Lists the names of tasks in the fixed task list. 


Lists the names of tasks that have SENDS queued 
for them. 


Lists the names of tasks in the ATL that have ASTs 
queued for them. 


Lists the names of all tasks in the STD that 
bound to one or more sharable global area and 
shared global areas to which each is bound. 


Lists the names of all tasks in the ATL, MRL 
CKQ. /BRF is used by default if no switches 
included in the SYS command. 


Lists all of the above except that which is 
produced by using /SGA. 


Lists the names of and the following information 
for installed tasks: version number, default 
partition and priority, task size, and fixed and 
multiuser indicators. See Figure 5-5. 


GENERAL USER COMMANDS 


Table 5-7 (Cont.) 
SYS Switches 


SWITCH FUNCTION 


/DEV 


Lists the name and PUD address of each symbolic 
device known to the~= system. On the listing, 
devices for which a device handler is resident are 
indicated by two asterisks (**). A redirected 
device is followed by the mnemonic of the device 
to which it was redirected. Spooled and mounted 
(MOU) devices are indicated by the words SPOOLED 
and MOUNTED, respectively. The number following a 
spooled device is its current forms type. 


List the following description of each memory 
partition in the system: name, base address 
(octal), size (octal), and partition type. 
Partition type can be: 


U (user-controlled), 
S (system-controlled, priority~-oriented), 
T (system-controlled, time~-scheduled). 


Lists the following description of each installed 
shareable global area: name, base address 
(octal), size, UIC, access, position independent 
or blank, creation date. 


NOTE 


Each scan performed by SYS inhibits’ task 
switching for a significant period of 
time. Therefore, SYS /FUL should not be 
issued frequently. 


1 2 3 4 5 6 7 8 
FI1ACP vo205 GEN 245 021500 DP 0-00000005357 FIXED 
Task name 
Version number of task 
Default partition name 
Priority of task 
Size of task (octal) 
Device identification 


Disk address (octal) 


Contains the word "FIXED" if the task is fixed in memory, or 
CHECKPOINTED" if the task is checkpointed. 


Figure 5-5 
Sample TASK LIST Listing and Descriptions of Listed Items 
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EXAMPLES 


1. 
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MCR>SYS /ATL 


ATL: 

DP... TT.... DK.... LP.... ODS... 
SPR2.. DLLEX 

MCR>SYS /MRL 

MRL: 

- « -MAC .--TKB CRF... 


MCR>SYS /CKQ 
CKQ: 

NO ENTRIES 
MCR>SYS /IRQ 


IRQ: 


TTO: 
a4, PLP acer aX 
CIO: 

NO ENTRIES 
Co0: 

NO ENTRIES 
CLO: 

NO ENTRIES 
SY1: 

NO ENTRIES 
IPO: 


NO ENTRIES 


DT oie 


---MCR 


~»-9YS MO.... 


GENERAL USER COMMANDS 


MCR>SYS /CTL 
CTL: 

---SYS ...PIP DLLEX 
MCR>SYS /CTL:GEN 
CTL: 

---SYS DLLEX 
MCR>SYS /FTL 
FTL: 

F11ACP 

MCR>SYS /SRQ 
SRQ: 

NO ENTRIES 
NCR>SYS /ASG 
ASQ: 


NO ENTRIES 


10. 


MCR>SYS /SGA 


ACCLOG 
ERRLOG 
MO...- 
SPR... 
SPR2.. 
-. -ACT 
- - ~BOO 
-.-CNF 
-- -DMP 
-. eEDI 
+ «FLX 
-.-FOR 
---INS 
-.-LBR 
-- -MAC 
---MCR 
-. PIP 
- + -QUE 
-- «REM 
-. e-RJE 
22 eOYS 
---TKB 
-.-VFY 


SYSRES 
SYSRES 
SYSRES 
SYSRES 
SYSRES 
PROOT. 
SYSRES 
SYSRES 
PROOT. 
PROOT. 
PROOT. 
SYSRES 
SYSRES 
PROOT. 
PROOT. 
PROOT. 
PROOT. 
PROOT. 
SYSRES 
SYSRES 
SYSRES 
SYSRES 
PROOT. 
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SYSRES 
SYSRES 
SYSRES 


SYSRES 
SYSRES 


SYSRES 
SYSRES 


SYSRES 


NOTE 


PROOT indicates that the task is multiuser and has a 
read-only segment in its root. This is the segment 

of the task that is shared among all versions of the 
task. 


MCR>SYS /BRF 


ATL: 

DP.... ..-RJE TT.... ODK.... LP.... DS.... DT.... «©.-MCR ...SYS 
MO...-. ~--EDI 

MRL: 

NO ENTRIES 

CKQ: 

NO ENTRIES 


12. 


GENERAL 


MCR>SYS /FUL 
ATL: 
DP sacs. ae ROB: TPs 0-6.6 
MO... -. EDI 
MRL: 

NO ENTRIES 
CKQ: 

NO ENTRIES 
FTL: 
FI11ACP 
GCD: 
SYSRES 
CTL: 
---SYS ...MAC 
SRO: 

NO ENTRIES 
ASQ: 

NO ENTRIES 
IRQ: 

TT: 

NO ENTRIES 

CI: 

NO ENTRIES 

DK: 

NO ENTRIES 

DP: 


NO ENTRIES 


USER COMMANDS 


DK.... LP wise 


5-48 


DS.... 


DT.... 


» «MCR 


0+ SYS 


13. 
ACCLOG 


GENERAL USER COMMANDS 


MCR>SYS /TAS 


0203 
00 
06A 
03 

06 

07 
V005B 
0321 
DO0225 
v0007 
05 
V0O03F 
06 

1A 
VOO6A 
VO0O6A 
0602 
vo5 
v19 
vol 
vo5 
VOO5C 
vol 
0302 


GEN 


235 
050 


248. 


050 
248 
248 
248 
200 
220 
200 
248 
100 
248 
050 
100 
090 
248 
249 
221 
221 
221 
098 
221 
065 
250 
221 
050 
075 
055 
060 
221 
055 
050 
221 
075 
150 
050 
221 
221 
050 
230 
075 
221 
221 
055 
221 
100 
221 
221 
150 
221 
250 
250 
221 
221 
221 
150 
221 
050 
075 


003200 
037300 
003400 
027200 
003500 
003400 
004300 
011000 
022700 
004700 
003200 
003600 
005700 
001600 
010400 
011400 
014100 
003000 
003300 
006300 
003300 
015000 
000600 
057600 
003400 
001600 
023000 
005600 
030500 
047500 
003700 
061400 
040300 
024000 
023200 
020500 
064300 
003600 
004300 
100500 
002400 
011200 
005300 
011500 
030500 
006500 
022600 
004200 
002700 
014300 
003200 
037400 
037300 
005000 
006500 
004600 
007300 
002300 
075700 
006400 


0-00000050241 
0-00000045654 
0-00000046654 
0-00000226525 
0-00000046775 
0-00000047145 
0-00000047661 
0-00000053135 
0-00000054167 
0-00000051505 
0-00000047753 
0-00000053076 
0-00000050144 
0-00000021630 
0-00000017347 
0-00000021154 
0-00000054064 
0-00000032265 
0-00000021166 
0-00000024762 
0-00000022446 
0-00000006432 
0-00000015544 
0-00000077035 
0-00000220017 


0-00000016565 


0-00000173415 
0-00000051723 
0-00000015511 
0-00000057131 
0-00000025707 
0-00000030017 
0-00000104543 
0-00000046313 
0-00000054104 
0-00000046341 
0-00000102327 
0-00000025767 
0-00000032330 
0-00000030572 
0-00000030170 
0-00000053014 
0-00000045717 
0-00000030675 
0-00000012715 
0-00000045775 
0-00000030137 
0-00000045727 
0-00000030773 
0-00000046236 
0-00000046052 
0-00000227533 
0-00000174417 
0-00000047442 
0-00000006451 
0-00000046060 
0-00000046622 
0-00000032051 
0-00000062374 
0-00000051752 


MULTI-USER 


FIXED 


MULTI-USER 


MULTI-USER 
MULTI-USER 
MULTI-USER 


MULTI-USER 


MULTI-USER 


MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 


MULTI-USER 


MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 


MULTTI-USER 


MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 
MULTI-USER 


14. 


-.--UNF V16 
-.--UNL Vil 
-.-VFY DO520 
-.--WHO vVOl 


MCR>SYS /DEV 


TTO 
C10 
coo 
CLO 
Syl 
TPO 
NTO 
SPO 
WKO 
LPl 
XX0 
BPO 
MOO 
DT3 
DT2 
DT1l 
DTO 
cTl 
CTO 
CRO 
LPO 
TT20 
TT17 
TT16 
TT15 
TT14 
TTL 
TT12 
TT1l 
TT10 
TT7 
TT6 
TT5 
TT4 
TT3 
TT2 
TTI 
MT1 
MTO 
DSO 
DP1l 
DPO 
DK3 
DK2 
DK1l 
DKO 
SY0 


141500 
141562 
141644 
141726 
142010 
142072 
142154 
142236 
142320 
142402 
142464 
142546 
142630 
142712 
142774 
143056 
143140 
143222 
143304 
143366 
143450 
143532 
143614 
143676 
143760 
144042 
144124 
144206 
144270 
144352 
144434 
144516 
144600 
144662 
144744 
145026 
145110 
145172 
145254 
145336 
145420 
145502 
145564 
145646 
145730 
146012 
146074 
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xk 


TTO 
TTO 
TTO 
DPO 


DSO 
DSO 


kk 
kk 
*x*k 
*k 
kk 


Rk 


** 
** 
** 
** 
kk 
*k 
** 
** 
ek 
** 
** 
** 
** 
*&* 
xk 


** 
kk 
kk 
kk 
** 
kk 
kk 


DPO 


MCR 
MCR 
GEN 
GEN 


221 002700 
221 002700 
055 037300 
221 001500 


MOUNTED 


SPOOLED 0 


MOUNTED 


MOUNTED 


DP 
DP 
DP 
DP 


0-00000045307 MULTI-USER 
0-00000046006 MULTI-USER 
0-00000021203 MULTI-USER 
0-00000021174 MULTI~USER 


15. 


16. 


pay 


18. 


MCR>SYS /PAR 
SYDISK 113200 
MCR 116700 
GEN 133700 
TTY 735000 


MCR>SYS /COM 
SYSRES 174600 


MCR>SYS /ATL 
ATL: 

DP...- ~--RJE 
MO ss < 

MCR>SYS /MRL 
MRL: 


NO ENTRIES 
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003500 
015000 
601100 
014400 


016400 


anna 


1,1 RO LIB PI 05/06/75 


DKewse “LDPisec- DSckus:. DEsaas sosMCR <2.5Y5S 


551 
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TASK LIST 


5.19 TASK LIST COMMAND (TAS) 


Refer to the SYS /TAS command in Section 5.18. 
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TIME 


5.20 TIME COMMAND 
FUNCTION: 


The TIME command (TIM) allows the user to list the time and date 
on the terminal. 


FORMAT: 
TIME 
EXAMPLE: 
MCROTIME 


11/14/74 13:45:00 
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5.21 TERMINAL STATUS COMMAND (WHO) 
The terminal status command (WHO) indicates which terminals are in 
use, provides the UIC of the user, and indicates whether the user 
terminal is privileged or slave. It also indicates those terminals 
that were defined during system generation but which are not currently 
in use. 
FORMAT 

WHO 
EXAMPLE 

MCR>WHO 


TTO [1,1] PRIVILEGED 
TT1 [101,30] 


Privileged user 
commands are 


commands 
actually 
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that 
nonprivileged 


appear to duplicate 


commands 


capabilities for the privileged user. 


A list of the privileged user commands follows. 


ABORT 


- ALTER 


BAD 


- BOOT 


CANCEL 


DISABLE 


CISMOUNT 


ENABLE 


FIX 


INITVOL 


INSTALL 


- LOAD 


MOUNT 


MEMORY 


OPEN 


OPERATE 


PASSWORD 


REASSIGN 


REDTRECT 


REMOVE 


RUN 


SAVE 


SET 


TIME 


UFD 


UNFIX 


UNLOAD 


Commands are presented in alphabetic order. 


NOTE 
Please reread the Preface for 
explanation of the use of characters 
( / [ ] etc.) that indicate command 


format conventions. 


nonprivileged 


with 


enhanced 
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ABORT 
6.1 ABORT COMMAND (ABO) 
FUNCTION: 
The Abort command (ABO) allows the privileged user to terminate 
the execution of a specified task. 
FORMAT: 
ABO[RT]Ataskname [/TI=dev ] 
where: 

taskname is the name of the task being aborted. 

/TI=dev is an optional switch (appended to the taskname) 
which allows the user’ to abort any task in the 
system, by specifying its TI. (dev) is the device 
mnemonic for the terminal corresponding to the TI 
under which the specified task is running. 

NOTE 
If the requesting task was initiated at 
the requesting terminal, Or the 
designated task is not a multiuser’ task, 
the /TI switch is not required. 
EXAMPLES: 
hs, MCR>ABO SCAN 


2. 


MCR>ABO SCAN/TI=TT15 


PR 
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ALTER 


6.2 ALTER PRIORITY COMMAND (ALT) 


FUNCTION: 


The Alter priority 
alter the priority 


FORMAT: 


ALT[ER]JAtaskname[/T 


where: 
taskname is t 
/Ti=dev is a 
whic 
task 
the 
to & 
/PRI=nnn is 
prio 
to 2 
EXAMPLE: 


MCR>ALT SCAN/PRI=75 


command (ALT) allows the privileged user’ to 
of an active task or tasks. 


T=dev] /PRI=nnn[,taskname[/TI=dev]/PRI=nnn,...] 


he name of the task being altered. 


n optional switch (appended to the taskname) 
h allows the user to alter the priority of any 

in the system by specifying its TI. (dev) is 
device mnemonic for the terminal corresponding 
he TI under which the task runs. 


NOTE 


If the requesting task was initiated at 
the requesting terminal, or if the 
designated task is not a multiuser’ task 
the /TI switch is not required. 


the switch used to specify the new task 
rity. nnn is a decimal number ranging from 1 
50. 
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BAD 


6.3 BAD BLOCKS COMMAND (BAD) 


FUNCTION: 


WARNING 


Any data stored on disk pack will be 
destroyed when the BAD command is 
executed. 


The BAD BLOCKS command (BAD) is used to locate any unusable 
blocks on a disk pack. [In addition the BAD command records their 
locations in the last good block on the disk prior to the 
initialization of the disk with the INITVOL command. The BAD 
command may be executed simultaneously with other RSX-11D tasks 
which do not reguire the disk under test. The detection of bad 
blocks is desirable for any type of disk pack, especially for 
Multisurface disk packs, which, even when new, may contain 
several bad blocks. 


The BAD command detects bad blocks by writing a special worst 
case pattern in each block of the disk. Then, each block is read 
to verify the data. As bad blocks are detected, the locations 
ana the number of bad blocks are collected. When all blocks have 
been tested, the collected data is written into the last good 
block on the disk. 


After testing, the following message is printed and BAD exits’ to 
MCR: 


BAD~-TOTAL NO. OF BAD BLOCKS = nnnnn 
where nnnnn is the total number (decimal) 
of bad blocks found in all sets.* 


* There can be up to 102 sets of bad _ blocks. Each set can 
describe from 1 to 256 contiguous bad blocks. If this maximum of 
102 sets is exceeded the following error message is printed: 


BAD~-BAD BLOCK FILE OVERFLOW 


When INITVOL is executed using the /BAD = [AUTO] option, blocks 
identified as bad in the bad block data are allocated so they 
cannot be used for data storage. At the same time, the last good 
block on the disk pack (which includes the bad block data) is 
allocated, saving the data for subsequent initialization (e.g., 
in case a miStake is made in entering the INITVOL information). 
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FORMAT: 


The BAD command format is: 


BADAdev: 
where: 
dev: is the device specifier for the disk under test 
EXAMPLE: 


MCR>BAD DK1: 
BAD--TOTAL NO. OF EAD BLOCKS=42 


In the above example, disk DK1l is searched for bad blocks; 42 
bad blocks are detected. 


ERROR MESSAGES: 


Errors detected during BAD processing are reported to the user 
via error messages listed on the user's terminal. These error 
messages are detailed in Section A.2. 


TECHNICAL NOTES 


The disk must be off-line (i.e., not mounted). 
The disk must be formatted. 
The disk device must be a valid Files-1l supported device. 


The user will be warned not to use the disk pack as a system disk 
if block OQ is found to. be bad (block 0 is used to store the 
bootstrap record). 


BAD first writes the worst case pattern 26 (decimal) blocks at a 
time. If an error occurs, it then tests each individual block of 
the 26. It is possible for individual block testing to be 
successful, thereby indicating hardware malfunctions on long data 
transfers. As long as the test of individual blocks is 
successful, BAD does not report errors. 


The user may notice this situation if error logging is’ running 
while BAD is testing the disk. When BAD reports no bad blocks 
and error logging reports errors, the problem is probably in the 
disk controller rather than the particular disk volume. 
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BOOT 


6.4 BOOTSTRAP COMMAND (BOO) 
FUNCTION: 


The BOOTSTRAP command (EOO) allows the privileged user to perform 
either of the following mutually exclusive operations. 


1. Stop the present operating system and bootstrap that system 
or another system from any system device. 


Z. Copy a bootstrap block on to block 0 of the specified device 
from a specified RSX-11D system image file on the same 
device. 


FORMAT: 


The BOOT command can be specified in four different formats. 
Each format is discussed separately. 


Format 1 
BOO [T] 
When this format is used, BOOT issues the following prompt: 
BOO> 
The user must now enter another carriage return. 
When executed in this format the BOOT command causes the latest 


version of the file RSX.SAV (residing in the default directory file of 
the system disk) to be bootstrapped into memory. 


Format 2 
BOO [TjJAfilespec 
where: 
filespec is the file specifier for the file that contains, 


as its first record, the bootstrap routine to be 
used in re-bootstrapping the operating system. 
Table 6-1 contains a list of default values for 
BOOT file specifiers. 


When this format is used, the BOOT command causes the bootstrap 
routine to be loaded from the file specified by "“filespec". This 
bootstrap routine then loads the remainder of the file into memory 
thus starting up the new RSX-11D system. 
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Format 3 
BOO[T]A/WB 
wheres: 
/WB is the write bootstrap switch. 
When this format is used, a bootstrap routine is written on block 0 of 
the system device. The bootstrap routine is copied from virtual block 


one of the latest version of file RSX.SAV residing in the default 
directory file on the system device. 


Format 4 
BOO [T]Afilespec/WB 
where: 
filespec is the file specifier for the file that contains, 


as its first virtual block, the bootstrap routine 
to be used. Table 6-1 contains a list of default 
values for BOOT file specifiers. 


When this format is used, the bootstrap routine which is contained as 


the first virtual block, in the specified file, is copied out to block 
0 of the specified device. 


Table 6-1 
Defaults In BCO File Specifiers 


SPECIFTIER CEFAULT 


dev: SY: 


ufd The UFD which corresponds with 


the UIC under which the user logged on 


filename RSX 
. type - SAV 


sver Latest version 


TECHNICAL NOTES 


iy All devices, except the one from which the bootstrap operation is 
to be accomplished, should be dismounted. 


2% When a re-bootstrap is to take place, the currently running 
system should be quiescent (i.e., no tasks running) 


3% The device from which a task is installed is recorded in that 
task's STDC entry. Therefore, after bootstrapping a new system, 
any installed tasks must be present at the same place on their 
Original devices; e.g., a system pack cannot be moved from DKO 
to DK1l and then bootstrapped using the BOOT command. 
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4. Only as much memory as was specified at SYSGEN time will be 
loaded during the bootstrap operation. 

5 The file specified to BOO must have been created by SYSGEN, and 
must not have been moved or copied after creation. 

EXAMPLES: 

eg MCR>BOO 
In this example, the system is re-bootstrapped using the latest 
version of the system image file RSX.SAV which resides in the 
default directory file on device SY:). 

2s MCR>BOO DK1:[10,10]SYS.SAV 
In this example, the system is re-bootstrapped using the latest 
version of the system image file SYS.SAV which resides in 
directory file [10,10] on device DK1:). 

3s MCR>BOO /WB 
In this example, a bootstrap routine is copied from virtual block 
one of the system image file R&X.SAV (which resides in the 
default directory file on SY:) to block 0 of device SY:. 

4. MCR>BOO DK1: [10,10]SYS.SAV/WE 


In this example, a bootstrap routine is copied, from virtual 
block one of the system image file SYS.SAV (which resides in 
directory file [10,10] on DK1:) to block 0 of device DKI1:. 
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CANCEL 


6.5 CANCEL COMMAND (CAN) 

FUNCTION: 
The CANCEL command (CAN) allows the privileged user to cancel 
periodic rescheduling of tasks. 

FORMAT: 

CAN [CEL]Ataskname[/TI=dev] [,taskname[/TI=dev],...] 

where: 

taskname is the name of the task being canceled. 

/TI=dev is an optional switch (appended to the task name) 
which allows the user to alter the priority of any 
task in the system by specifying its TI. (dev) is 
the device mnemonic for the terminal corresponding 
to the TI under which the task runs. 

NOTE 
If the requesting task was initiated at 
the requesting terminal, or if the 
designated task is not a multiuser’ task 
the /TI switch is not reguired. 
EXAMPLES: 
Le MCR>CANCEL XKE 

Cancels all scheduled requests for task XKE (terminates periodic 

rescheduling). 

Ze MCR>CANCEL XKE,NK111 


Cancels all scheduled requests for’ task XKE and NK111l. 
(Terminates periodic rescheduling.) 
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DISABLE 


DISABLE COMMAND (DIS) 


FUNCTION: 


The DISABLE command (DIS) allows the privileged user to inhibit 
task execution without actually removing the task from the 
system. Disabled tasks cannot be initiated until they are 
enabled through the ENABLE command issued by a privileged user 
(see Section 6.8). 


FORMAT: 


DIS [ABLE]Ataskname[,taskname,...] 


wheres: 


taskname is the name of the task being disabled. 


EXAMPLE: 


MCR>DIS SCAN,RICK 


In this example, the tasks SCAN and RICK are disabled. Neither 


of these tasks can be initiated until a privileged user issues 
the ENABLE command. 
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DISMOUNT 


6.7 DISMOUNT VOLUME COMMAND (DMO) 
FUNCTION: 


The DISMOUNT VOLUME command (DMO), for the privileged user, is 


functionally the same as for a nonprivileged user; the 
difference is that only a privileged user is allowed to dismount 
the system volume. 
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6.6 ENABLE COMMAND (ENA) 
FUNCTION: 


The ENABLE command (ENA) reverses 
command (see Section 6.6). 


FORMAT: 
ENA[BLEJAtaskname[,taskname,...] 
where: 
taskname is the name of the 
EXAMPLE: 
Le MCR>ENA SCAN 


2. MCR>ENA SKE,RICK,JEN 


ENABLE 


the effects of the DISABLE 


task being enabled. 


In the examples above, tasks SCAN, SKE, RICK, and JEN are 
enabled, thus making them available for execution. 
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FIX 


6.9 FIX-IN-MEMORY COMMAND (FIX) 
FUNCTION: 
The FIX-IN-MEMORY command (FIX) allows the privileged user to FIX 
a task in its default partition; i.e., to dedicate memory to a 
task for faster response to requests for execution. The user 
cannot FIX a task unless it was built as a fixable task. 
FORMAT: 
FITXAtaskname [/TI=dev] [,taskname[/TI=dev],...] 
where: 
taskname is the name of the task being fixed in memory. 
/TI=dev is an optional switch which specifies the TI under 
which the task is to be fixed. dev is the device 
Mnemonic for the terminal corresponding to the TI 
under which the task is to run. 
EXAMPLES: 
Ls MCR>FIX XKE 
2 MCR>FIX JAG, 2402 
In the examples above, the tasks XKE, JAG, and 2402 are fixed in 
their default partitions. 
36 An SGA can be fixed in memory by writing a dummy task that uses 


that SGA. The dummy task should be built with the following 
options, which are described in Chapter 3 of the RSX-11D Task 
Builder Reference Manual: 


/~-CP /-FP /FX 


STACK = 10 
UNITS = 0 
LIBR = sga name or COMMON = sga name 


Example of dummy task: 
-MCALL EXITSC 
START: 


EXITSC s in case task is executed 
END START 


The dummy task uses 96 words; this includes the task header and 
minimum stack size, plus one FTL entry. The above approach is 
the optimal solution to fixing an SGA. 


Fixing the dummy task guarantees the loading and fixing of the 
SGA it uses. Both the task and SGA should be installed in the 
Same partition. 
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INITVOL 


6.10 INITIALIZE VOLUME COMMAND (INT) 


WARNING 
Any data stored on the volume will be destroyed when INI 
is executed. 
FUNCTION: 
The INITIALIZE VOLUME command (INI) provides the privileged user 


with a facility for producing new Files-1l structured volumes. 
Files-1l structured volumes are discussed in detail in the IAS/ 


RSX-11 I/O Operations Reference Manual. 
FORMAT: 


INI [TVOLJAdev: [volumelabel] [/keyword(s) ] 


where: 
dev: is the device specifier for any file structured 
media. 
volumelabel is the label being assigned to the volume. 
NOTE 
Volume labels can be from 1 to 12 
alphanumeric characters in length. The 
only exception is magnetic tape volumes 
which are from 1 to 6 alphanumeric 
characters in length. 
Volume label must be specified for 
magnetic tape. 
/keyword(s) define the volume characteristics. If no keywords 
are specified, the default characteristics are 
used (see individual keyword descriptions). The 


following keyword options are provided. 


NOTE 


Notations listed to the left of keyword 
options, equate to the following: 


*= Valid for disk and DECtape only 


**= Valid for magnetic tape only 


/UIC=[group number ,member number] 


* 
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Default 
/UIC=[1,1] 


/PRO=[system,owner ,group,world] 


This keyword allows the user. to 


Each 
consists of from one to four letters 


volume access privileges. 
have the following meanings: 
R - for READ access 
W - for WRITE access 
E.~ for EXTEND access 


D - for DELETE access 


establish 


entry 
which 


The absence of a code letter means the access 


right is denied to the user. 


Protection code subparameters 
(system,owner, group,world) are positional; 
therefore, the location of the entry in 
parameter string defines the user to whom the 


codes apply. 
Example 
/PRO=[RWED,RWED, RW, RW] 


In this example, group and world 
extend and delete access. 


Default 


/ PRO=[RWED, RWED, RWED, RWED] 


NOTES 


the 


are denied 


1. On 


Magnetic tape, the protection 


option delete is eacuated to write, 
since write access’ implies total 
access because of the sequential 
nature of magnetic tape. 


2. Extend access may be specified 
without write access. This implies 
that the user may extend the last 


file 


the 


/MXF=max imum 
volume. 


on the volume, but not write on 
volume in any other manner. 


number of files allowed on this 
The highest maximum permitted is one 


half the number of blocks on the volume or 
65535 decimal, whichever is less. 
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Example 
/MXF=100 
Default 


One fourth the number of blocks on_ the 
volume 


/EXT=default file extension size in blocks. 
Default 
/EXT=5 
/FPRO=[default file protection] 


This parameter is entered using the same 
format as the /PRO keyword. 


Default 
/FPRO=[RWED, RWED, RWE,R] 
/CHA=[characteristic words] 
This keyword defines the device 
characteristics. The possible parameters for 


this keyword follow. 


ATCH ~- device may be attached for 
exclusive use by one task. 


DCF -~ device control functions 
permitted; CsdisG Read/Write 
logical. 

Example 


/CHA=[ATCH, DCF] 
Default 
No ATCH and no DCF 


/7INF=number of file headers to allocate in the 
initial index file. 


Default 
/ INF=16 


/WIN=Gefault window size for file access to this 
volume. Represents the number of retrieval 
pointers. 


Default 


/WIN=7 
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* /LRU=number of directories to keep pre-accessed 
while volume is in use. For optimized 
directory access this value should 
Slightly higher than the expected number of 


concurrent users of the volume. 
Default 
/ LRU=3 


** /DENS=magnetic tape density 


Enter 800 for 800 BPI, or 1600 for 1600 BPI. 


Default 
/DENS=800 
* /INDX=Option - Index file position. 
Options are: 
BEG ~ beginning of volume 
MID - middle of volume 
END ~ end of volume 
BLK:number - logical block number 
Example 
/ INDX=BLK: 100 
Default 
/ INDX=MID 


/BAD=[options]-Initialize bad block file. 
are: 


AUTO - use bad block data left on volume 
by BAD command (see Section 6.3). 


MAN - enter’ bad blocks in 


described in section 6.10.1. 


Tf both options are used, they must 


separated by a comma. 
Example 
/ BAD= [AUTO] 
Or 
/ BAD= [AUTO, MAN] 
Default 


none 
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6.10.1 MAN Option for /BAD Keyword 


When "MAN" is specified as the /BAD Keyword option, INI will issue the 
following prompt: 


INI>BAD= 


This prompt is issued after the INI command line is terminated, and 
before INI begins processing (initializing) the requested volume. 


After INI issues the prompt, the user can begin entering bad block 
location data. Bad block data is entered immediately following the 
equal sign (=) in the following format. 


INI>PAD=u[ ,n] 


where: 
u is the logical block number, in octal, of the 
initial bad block in the group. 
n is the number, in octal, of consecutive blocks 


contained in the group. If omitted, a value of 
one is assumed. 


NOTE 


If a decimal number is used for either u 
or n, it must’ be followed by a decimal 
point (.). 


After the first group of bad blocks is entered, INI reissues’ the 
prompt. The user can, if necessary, enter more bad block data by 
simply repeating the above procedure. 


To terminate, the user need only enter a carriage return 
immediately following the equal sign (=) without entering data. 


Upon termination, the initial INI command line, including the bad 
block data, is processed, and the requested volume is 
initialized. 


TECHNICAL NOTES 


Because of the large number of options available with the INI 
command, it may not be possible to enter the entire command 
string on a single line. For this reason, INI has been modified 
to accept multiline commands. To accomplish this, the user must 
follow the procedure outlined below. 


1. MOU must be initiated as follows: 
MCROINI 


When INI is ready to accept command lines, the _ following 
prompt is issued. 


INI> 
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2. At this point, multiple lines can be typed in to INT. Each 
line except the last must contain a hyphen (-) as the last 
character entered. When INI recognizes the hyphen, it 
assumes that the command line is incomplete, and reissues the 
INI> prompt for more parameters. When the last line is 
entered (no hyphen), INI begins processing the command. See 
example number 3. 


EXAMPLES: 


1. 


MCR>INI DK1:TESTPACK/CHA=[ATCH , DCF] /BAD= [AUTO] 


In this example, a disk volume on DKl: is initialized with the 
following characteristics: 


Volume label ~ TESTPACK 

UIC - [1,1] 

Volume Protection - System = RWED 
Owner = RWED 
Group = RWED 
World = RWED 

Maximum number of - 1200 

files 

Default file extension = 5 

File protection ~ System = RWED 
Owner = RWED 
Group = RWE 
WORLD = R 

Characteristic word ~ ATCH and DCF 

Index file position - MID 

Bad blocks ~ Automatically accounted for. 

Number of headers - 16 

in index file 

Window size st 

Number of pre-accessed - 3 


directories 
MCR>INI DKl:TESTPACK/PRO= [RWED,RWED,RW,R] /CHA=[ATCH , DCF] /BAD= [MAN] 
INI>BAD=6.,10. | 
INI>BAD=12. 


INI>BAD= 
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In the above example, a disk volume on DK1: is initialized with 
the following characteristics. : 


Volume label 
UIC 


Volume protection 


Maximum number of 
files 


Default file extension 


File protection 


Characteristic word 
Index file position 
Bad blocks 


Number of headers 
in index file 


Window size 


Number of pre-accessed 
directories 


MCR>INI 


TESTPACK 
[1,1] 


System = RWED 


Owner = RWED 
Group = RW 
World =R 
1200 

5 


System = RWED 


Owner = RWED 
Group = RWE 
World =R 


ATCH and DCF 
MID 
6 through 17, and 12 


16 


INI> DK2:FRED/UIC=[301,275] /LRU=2- 


INI> /PRO=[RWED,RWED,R,]/INDX=BEG— 


INI> /MXF=1000. 


MCR> 


In the above example, a disk volume DK2: is initialized with the 
following characteristics: 
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Volume label 
UIC 


Volume protection 


Maximum number of 
files 


Default file extension 


File protection 


Characteristic Word 
Index file position 
Bad blocks 


Number of headers in 
index file 


Window size 


Number of pre-accessed 
directories 


FRED 


[310,275] 
System = RWED 
Cwner = RWED 
Group =R 
World = No access 
1000. 

5 

System = RWED 
Owner = RWED 
Group = RWE 
World = R 


No ATCH and no DCF 


BEG 


Not accounted for 


16 
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INSTALL 


INSTALL TASK COMMAND (INS) 


FUNCTION: 


The INSTALL TASK command (INS) installs tasks and sharable global 
areas (SGAs) in the system. It can also override or extend some 
of the attributes assigned to the task by the task builder. 
These overrides are specified in the form of keyword parameters 
appended to the task image file specifier(s) in the INS command 
line. 


FORMAT: 


INS [TALL] Afilespec [/keyword(s)][,filespec[/keyword(s)],...] 


wheres 


Or 
INS [TALL] A@indirect 
filespec is the file specifier for the image (task or 
sharable global area) being installed. Table 6-2 
contains a list of defaults in INS file 
specifiers. 
/keyword(s) option parameter(s) used to override or extend 


arguments assigned at task-build time. The 
following keyword options are provided: 


/PAR=partition name 


This option specifies the partition into 
which the task or global area is to be 
installed. 


On the installation of a sharable global area 
(SGA) INSTALL will recognize the special 
pseudo partition name $S$SEXT, and will align 
that SGA on the external page in real memory. 
Furthermore, the SGA will be flagged as if it 
were loaded but no actual load will occur. 
This function allows a task to bind to a 
common area, for example, and reference 
locations symbolically in the external page. 


Example 


/ PAR=GEN 
/ PAR=SSSEXT (for SGAs only) 


Default 
In order: 


The partition specified when building 
the task or SGA, or if none, : 
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The partition specified as the default 
during system generation. 
/PRI=priority-number (decimal) 
This option specifies the execution priority 
to be assigned to the task. Priority ranges 
from a low of 1 to a high of 250. 
Example 
/PRI=200 
Default 
/PRI=50 
/TASK=taskname 
This option allows the user to assign a name 
to the task or SGA being installed. This 
name overrides the one assigned by the Task 
Builder. Task names can be from 1 to 6 
alphanumeric characters in length. 
Example 
/TASK=RICK 
/POOL=pool-limit (decimal) 


This option allows the user to assign a new 
pool limit to the task being installed. 


The pool limit value can be from 0O to 255 
decimal, and represents the maximum number of 
8-word nodes that the task is allowed to use 
at one time. 
Example 

/ POOL=100 
Default 

/POOL=40 (established by task builder) 

/UIC=[uic] 


This option allows the user to change the 
task's UIC, or the owning UIC of an SGA. 


Example 


/uIc=[(11,11] 
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/RUN[=REM] (run-remove) 


This option is different from the a 
mentioned options, in that it does not ch 


bove 
ange 


any task attributes. When /RUN is specified, 


it directs INS to install the specified 
and run it. 


Tf the optional subparameter "“=REM" 
appended to /RUN, it specifies that the n 
task is to be removed after execution. 


/TIM=allowable run time expressed as nH, nM, 
or nT. 


This option allows the user to specify 
length of time the task is allowed to run 
is the decimal number of hours, minu 
seconds, or ticks the task is allowed to 
Hours, minutes, seconds, Or ticks 

represented as H, M, S, or T, respectivel 


Example 


/TIM=20M (task is to run 20 minute 


NOTE 


This keyword has no effect if system 
accounting is not running, or if the 
task being installed was task built 
as a non-accountable task. In the 
latter case, however, a diagnostic 
message is issued. See Chapter 2 of 


the RSX-11D System Manager's Guide. 


/ACC=non-owner access expressed as RO, RW, or 
This switch allows the user to. specify 
access privileges afforded non-owners 
specified SGA. A non-owner of a SGA is 
whose UIC does not exactly match that of 
SGA. RO, RW, and NA equate to read o 
write only, no access, respectively. 
Example 

/ACC=RO 
Default 


/ACC=NA 


task 
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TECHNICAL NOTES: 


1. 


2. 


Chapter 7 
describes the building of a shareable global area. 
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/LI and /CM 


These options are used to specify that the 
entity being installed is either a library 
(/LI) or a common area (/CM). By definition, 
a common area has read/write access. 
Application of the /CM switch ensures” that 
such data is written back to the SGA file 
when all binding tasks become inactive. See 


Chapter 5 of the RSX-11D System Manager's 
Guide. 


Default 


/CM 


NOTE 


Install determines that the file 
being installed is a sharable global 
area. The switches /ACC, /LI, and 
/CM have no effect on the 
installation of ordinary tasks. 


/INC=task size increment 


or 


This switch overrides the EXTTSK task builder 
option. It specifies the decimal number of 
words by which the upper read/write area of 
the task is to be extended. The value 
specified will be rounded up to the next 32 
word boundary. This option is illegal for 
shareable global area. 


Example 
/ INC=2048 


Allocates as additional 2K to the task's 
address space. 


Default 


Either O or the EXTTSK value. 


the RSX-11D Task Builder Reference Manual 


All SGAs to which a task is bound must be installed before 


the 


task 


is 


installed. They need not be installed before 


building the task. 
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Table 6-2 
Defaults in INS File Specifiers 


SPECIFIER DEFAULT 


Tf omitted in the first or only file specifier, 
SY: is used. 


Tf omitted in the second through n file 
specifiers, the device specified or defaulted from 
the previous file specifier is used. 


If omitted in a file specifier, the UFD that 
corresponds to the UIC under which the user logged 
on is used. 


filename Must be specified. 


. type - TSK 


sver The latest version for the file. 


EXAMPLES: 
Ae MCR>INS SCAN 


In this example, the latest version of the task image file 
SCAN.TSK is selected, and the task image which it contains is 
installed. None of the task attributes that were assigned to the 
task at task~-build time are changed. 


2 MCR>INS DK1: [11,2]SCAN. ;3/PRI=103,RICK/TASK=HELP 


In this example, the tasks to be installed reside in directory 
file [11,2] on DKl:. Version ;3 of task image file SCAN.TSK, and 
the latest version of task image file RICK.TSK are selected. The 
task images contained in these files are installed into the 
system, with the following modifications being made to them. 
Task image SCAN will have its priority changed to 103, and task 
image RICK will have its name changed to "HELP". 
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LOAD 


6.12 LOAD COMMAND (LOA) 

FUNCTION: 
The LOAD command (LOA) allows the user to specify that an 
indicated device handler be made resident in memory and ready for 
service. I/O requests to a device are not honored unless’ the 
requested device handler is resident. 

FORMAT: 
LOA [DJA handler-name[: ] 

where: 
handler-name is the task name of the handler to be loaded. 


EXAMPLE: 


MCR>LOAD LP 


The line printer device handler is loaded into memory. T/O 
requests to the LUN assigned to the line printer can now be 
honored. 
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MEMORY 


6.13 MEMORY UNLOCK (MEM) 
FUNCTION: 


The MEMORY UNLOCK command allows the user to unlock tasks that the 
Executive locked in memory as a result of a main memory parity error. 


Parity error handling is discussed in The RSX-11D System Manager's 
Guide. 


FORMAT: 
MEM[ORY]A[taskname] [/switches][,taskname[/switches]][,...] 


taskname is optional. If specified, it is the name of the 
task to be freed. MEM searches the ATL and 
unlocks the first locked task encountered with the 
specified name. The task name must be included if 
a series of specifications are included in the 


command. 
switches can be either or both of the following options. 
/TI=xxn indicates that the first locked task encountered 


in the ATL with the specified TI is to be 
unlocked. The value xxn is the device mnemonic; 
for example, TT3. 


If both taskname and TI are specified in the MEM 
command, the first locked task encountered in the 
ATL with the specified taskname and TI assignment 
is freed. 


/AL indicates that all locked tasks are to be freed. 
If both taskname and /AL are specified, all locked 
tasks with the specified taskname are freed. 


If both /TI and /AL are specified, all locked 
tasks with the specified TI are freed. 


If taskname, /TI, and /AL are specified, all 
locked tasks with the specified taskname and TI 
are freed. 
EXAMFLES: 
MCR>MEM /AL 


MCR>MEM ABC/TI 
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MOUNT 


6.14 MOUNT VOLUME COMMAND (MOU) 
The MOUNT volume command (MOU) for the privileged user has the same 
format as MOU for the nonprivileged user. The privileged user does, 


however, have three switch options that are not available to the 
nonprivileged user. These options are as follows: 


/UIC=[uic] 


This option specifies the volume UIC to be 
used for the duration that the volume is 
mounted. 


Example 
/uUICc=[11,11] 
/OVR 
This switch allows the user to override the 
volume label check. 
NOTE 
This option must be specified when 


mounting magnetic tapes with blank 
volume labels. 


/PRO=[system, owner, group, world] 


This option allows the user to change’ the 
volume access privileges. Each entry 
consists of from one to four letters which 
have the following meanings. 


R - for READ access 

W - for WRITE access 

E - for EXTEND access 

D - for DELETE access 

The absence of one of these letters in an 
entry signifies that the access right is 
denied to the user. 

Protection code subparameters (system, owner, 
group, world) are positional; therefore, the 


location of an entry in the parameter’ string 
defines the user to whom the codes apply. 
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Example 
/ PRO=[RWED, RWED, RW, RW] 


In this example, group and world are denied 
extend and delete access. 


EXAMPLE: 
MCR>MOU DK1:SYS004/UIC=[200,200] 


In this example, a request is made to mount disk volume SYS004 on 


DK1l:. A request is also made to replace the volume's default UIC 
with "[{200,200]". 
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6.15 OPEN REGISTER COMMAND (OPE) 


FUNCTION: 


The OPEN Register command (OPE) allows the privileged user _ to 
open a memory address (gain access to it) for examination and 
optional modification. 


When a location is opened the specified memory address and_ the 
contents of the address are listed on TI:. The format of this 
message is shown in Figure 6-1. 

FORMAT: 
OPE[N]Amemory address[+tor-n] [/option(s) ] 

where: 

memory address address (octal) is the location to be opened. 

n is an optional number to be added to the memory 
address, if positive, or subtracted from the 
memory address, if negative. 

/option(s) The following options specify the address space to 
which the memory address applies: 

NOTE 
If no option is specified, the address is 
interpreted as an absolute memory address. 
If an option is specified, the address is 
interpreted as a virtual address within 
the specified address space. 
/TASK=task name[/TI=dev] 


/PAR=partition name 


/KNL=specifies kernel virtual address 
space 
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FORMAT 


memory-address contents/new-value or line-terminator 


where: 


memory~-address (printed by the system) is the 6-digit (octal) 
virtual address 


contents/ (printed by the system) is the 6-digit (octal) 
value at the memory-address, followed by a slash 


(/) 


new-value (typed in by user) is the new value entered into 
the memory-address 


line-terminator (typed in by user) is one of the optional line 


terminators; see list of line terminators below 


Line Terminator Options 


ESCape or ALTMODE: end of command. The ESC (or 
ALTMODE) key is’ the only means of exit from the 
OPEN MCR function. 


carriage return: the next sequential location is 
opened. 


up-arrow return: the previous location is opened. 
asterisk carriage return: the location pointed to 
by the final contents of the opened location is 


opened. 


Figure 6-1 
Format of Open Register Command Output 


EXAMPLES: 


I 


MCR>OPEN 4 10/KNL 
000014 060014/350 
000016 071005/(8) 


In this example, the value of the memory address is 4, "n" equals 
10 (a positive number that is added to the memory address 
yielding the effective address "000014"). The option specified 
is Kernel Virtual. The System responds by printing the address 
(000014) and the contents of the address (060014), followed by a 
Slash. The user responds by entering the new value "350", 
followeGc by a carriage return. Terminating the line by a 
Carriage return causes the next sequential location to be 
displayed. The dialogue is then terminated by entering ALTMODE. 


MCR>OPEN 4/TASK=ABC 


000004 111111/ 
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In this example, memory location 4 of task "ABC" is opened. The 
memory address (000004) and its contents (111111) are printed. 
After examining the contents of this address, the operator can 


either enter a new value or examine other locations by typing one 
of the line terminator options. 


MCR>OPE 4 


000004 0305/20054 ($) 


In this example, absolute location 4 is displayed, and modified 
to contain "20054". 
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6.16 OPERATE COMMAND (OPR) 


The CPERATE command (OPR), for the privileged user, has the same 
format as OPR for the nonprivileged user. The privileged user does, 
however, have three switch options that are not available to_ the 
nonprivileged user. These options are described in Table 6-3. 


Table 6-3 
Operate Option Switches 


SWITCH CESCRIPTION 


Set the forms type in the PUD of the specified 
device to 7. When printing of the current file 
has completed, the user can mount new forms on the 
device and queue a test pattern file to test for 
forms alignment (see CUE command option /TE, 
section 5.15.) 


Set the forms type in the PUD of the specified 
device to n (where n is a decimal number ranging 
from 0 to 6). Processing of files requiring the 
specified forms type and device type begins 
automatically. 


Recycle all active orders and regqueue them as 
inactive. Automatically begin processing queued 
files, directed to the specified device, having 
matching forms types. 
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PASSWORD 


6.17 ENTER PASSWORD COMMAND (PWD) 


The ENTER PASSWORD command (PWD) is functionally the same for the 
privileged user as it is for the nonprivileged user, with this 
exception: the privileged user can change the password for any UFD on 
any volume that is not protected against system access. 
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QUEUE 


6.18 QUEUE COMMAND (QUE) 
FUNCTION: 


The QUEUE command for the privileged user has the same format as_ the 
QUE command for the nonprivileged user. The privileged user does, 
however, have the option of deleting (/KIL) or modifying any queued 
entry in the Queue Manager tasks queue. 


The format of the delete or modify command is identical to the 
nonprivileged delete or modify command format. The only important 
distinction is that any privileged user that modifies a queued entry 
becomes the owner of the modified entry. 
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6.19 REASSIGN CCMMAND (REA) 


FUNCTION: 


The REASSIGN command (REA) allows the operator to reassign 
logical unit numbers (LUNs) of a particular task from one 
physical device unit, and assign them to another. 


FORMAT: 


REA[SSIGN]AtasknameAlunlistAdevunit: 


where: 
taskname name of the task whose LUNs are being reassigned. 
lunlist list of one or more logical unit numbers separated 
by commas. 
devunit new device unit symbol followed by the unit 
number. 
EXAMPLES: 
Ls MCR>REASSIGN JOE; 3 TTO: 
Zs MCR>REA BILL 2,3,4 TT1: 
36 MCR>REA SAM 5 NONE 


In the examples above, the requests are to: 
1. REASSIGN, in task JOE, logical unit number 3 to device TTO. 


2. REASSIGN, in task BILL, logical unit numbers 2, 3 and 4 to 
device TT]. 


3. REASSIGN, in task SAM, logical unit number 5 to NONE. TE: 5 


was previously assigned to LPO, for example, nothing would be 
printed on LUN 5. 


TECHNICAL NOTES: 


The REASSIGN command performs reassignments in the indicated 
task's disk image. 


The REASSIGN command does not affect a memory~-resident task. 


Removing and re-installing a task will restore its LUNs to their 
Original assignments specified at task build time. 
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REDTRECT 


6.20 REDIRECT COMMAND (RED) 
FUNCTION: 
The REDIRECT command (RED) allows the Speen to redirect all 
I/O requests from one physical device unit to another. This 
command can be used if one of the I/O units needed for a task is 
inoperable for some reason. 
FORMAT: 
RED [IRECT]Anew-dev:=old-dev: 
where: 
new-dev: is the new device unit symbol, followed by an 
. optional unit number (zero is assumed). 
= is notation signifying the redirect action. 
old-dev: is the old device unit symbol, followed by an 
optional unit number (zero is assumed). 
NOTE 
TI: cannot be designated as old-dev, but 
it can be designated as new-dev. 
EXAMPLES: 
Ls MCR>REDIRECT TT3:=TT6: 
2. MCR>RED TT=LP: 
as MCR>RED LP:=LP: 
In the examples above the reguests: 
Le Redirect all I/O requests from device TT6 to device TT3; 
2. Redirect all I/O requests from device LPO to device TTO. 
3 Reverse the redirection specified in example 2. 


TECHNICAL NOTES: 


1. 


2. 


The RED command does not redirect any I/O already in the queue. 
Previous I/C requests are not transferred. 


If, through a sequence of Redirect commands, the user establishes 
a redirect chain which returns to old-dev, the following message 
is issued, and the RED command is rejected: 


RED ~~ CIRCULAR REDIRECT CHAIN 
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Example: 
MCR>RED TT2:=TT1: 
MCR>RED TT3:=TT2: 
MCR>RED TT1:=TT3: 


RED ~~ CIRCULAR REDIRECT CHAIN 
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6.21 REMOVE COMMAND (REM) 


FUNCTION: 


The REMOVE command (REM) allows the privileged user’ to 


inactive, unfixed task out of the system. 


REMOVE 


take 


an 


Tt also allows the removal of sharable global areas whose binding 


tasks are not installed. 
FORMAT: 


REM [OVE]Anamel [/switch] [,name2[/switch],...] 


or 
REM [OVE] A@indirect 
where: 

name is the name of a task or sharable global area 
being removed. 

/switch an optional switch used to identify sharable 
global areas to be removed. The following switch 
values are available for use: 

/LI identifies the named global area as 
being a library. 

/CM identifies the named global area as 
being a common area. 

@indirect is an indirect command file specifier for a file 
which contains a list of REMCVE commands. 

NOTE 
Three levels of indirection are supported. 

EXAMPLES: 
ds MCR>REM SCAN 

In this example, the task SCAN is removed from the system. 
2. MCR>REM SCAN, XKE,JAG 

In this example, tasks SCAN, XKE, and JAG are removed from the 

system. 
36 MCR>REM SOMLIB/LI 

In this example, the library "SOMLIB" is removed, providing that 


none of its binding tasks are installed. 
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6.22 RUN COMMAND (RUN) 


FUNCTION: 


The 
any 


es 


RUN command allows the privileged user to initiate tasks in 
of six different forms as follows: 


Request the execution of a task when memory becomes 
available. 


Execute a task, contingent upon immediate memory availablity 


Run a task at a specified future time and, optionally, rerun 
it periodically 


Schedule the task for running at a specified future time and, 
optionally, rerun it periodically 


Synchronize the running of a task with a time unit and, 
optionally, rerun it periodically 


Run a task that is not installed in the system. This form of 
the RUN command is described in section 5-17. 
NOTE 


1. If the user is running an uninstalled task, the only 
switch options available for use are 


/UIC=, /PAR=, /PRI=. 
2. The default UIC for the general user is the UIC under 


which the user logged on. For the privileged user, 
the default UIC of the task being run is used. 
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RUN 


REQUEST form of command 
The "Request" form of the RUN command allows the operator to 
request the execution of tasks. 
NOTE 


If memory is not available, the task will be queued until 
memory becomes available. 


FORMAT: 


RUNAtaskname [options] [,taskname [options] ,...] ($) 


where: 
taskname is the name of the task being run 
options are any of the following: 
/PRI = priority number (decimal) 
/PAR = partition name 
/UIC = [user identification code] 
EXAMPLES: 


MCR>RUN SCAN(S$) 

MCR>RUN SCAN/PAR=XYZ/PRI=58 (S) 

MCR>RUN XKE,NK111/PRI=10,SCAN(S$) 

MCR>RUN XKE/UIC=[11,1] (8) 
TECHNICAL NOTE: 


l. Execution is contingent upon priority and memory 
availability. 


2. See Section 4.2 for a description of the UIC under which the 
task will run. 
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RUN 
EXECUTE form of command 
The "Execute" form of the RUN command allows task execution contingent 
upon priority. 
NOTE 
If no memory is available in the 


specified or default partition, the 
request is rejected. 


FORMAT: 
RUNAtaskname/MEM[/options] [,taskname/MEM[/options],...] (S$) 
where: 
taskname is the name of the task being run 
options are any of the following: 
7PRI = priority number 
/PAR = partition name 
/UIC = [user identification code] 
EXAMPLES: 


MCR>RUN SCAN/MEM (S) 
MCR>RUN SCAN/MEM/PRI=100/PAR=XXX/UIC=[1, 3] (S) 
MCR>RUN SCAN/MEM/PRI=25 , 240Z/PAR=2/PRI=99 ($) 
TECHNICAL NOTES: 
1. Execution is contingent upon priority. 


2's The “Execute” form of the RUN command aoes not cause 
checkpointing to occur. 
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RUN 


RUN form of command 


The "Run" form of the RUN command allows the operator to schedule 
tasks in terms of "delta time from now" with the option to 
specify periodic reschweuling, run priority, and memory 
partition. 


FORMAT 


RUNAtasknameAtime [options] [,tasknameAtime [options] ,...] (S) 


wheres: 
taskname is the name of the task being run 
time is the "delta time from now" the task is to begin 
execution. Delta time is expressed as nH, nM, nS, 
or nT where n is the decimal number of hours, 
minutes, seconds, or ticks. 
options are any of the following: 
/RSI = reschedule interval expressed as nH, 
nM, nS, or nT 
/PRI = priority number (decimal) 
/PAR = partition name 
/UIC = [user identification code] 
EXAMPLES: 
1. | MCR>RUN XKE 15M(8) 
2. MCR>RUN XKE 15M/RSI=90S/UIC=[3,1] (S) 
3. MCR>RUN XKE 15M/RSI=GOS/PRI=150/PAR=XYZ (S) 
4. MCR>RUN XKE 15M,NK111 20M,240z 25M(S) 
In the examples above, the requests are to: 
5 Run task XKE 15 minutes from now 
2 Run task XKE 15 minutes from now, rescheduling it every 90 
seconds. The user identification code is [3.1] 
3% Run task XKE in 15 minutes, rescheduling it every 90 seconds, 
assigning it a priority of 150, and running it in partition XYZ. 
4. Run task XKE in 15 minutes, run task NK111 in 20 minutes, and run 


task 240Z in 25 minutes. 
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SCHEDULE form of command 


The "Schedule" form of the RUN command allows the operator’ to 
schedule tasks in terms of absolute time of day, with the option 
to specify periodic rescheduling, run priority, and memory 
partition. 


FORMAT: 


RUNAtasknameAt ime [options] (S$) 


where: 
taskname is the name of the task being run 
time is the absolute time of day the task is to begin 
execution. Time is expressed as hours: minutes: 
seconds [:ticks] 
options are any of the following: 
/RSI = reschedule interval, expressed as nH, 
nM, nS, or nv. 
/PRI = priority number 
/PAR = partition name 
/UIC = [user identification code] 
EXAMPLES: 
1. MCR>RUN XK1 12:23:15(S) 
2 MCR>RUN XKE 12: 00:00/RSI=6M/PRI=99/PAR=XYzZ ($) 
3.  MCR>RUN SCAN 23:30:00/RST=10M/PRI=200 ($) 
4. MCRRUN XKE 1:00:00,2402 1:30:00/UIC=[111,1] G) 
In the examples above the reguests are to: 
rs Schedule task XK1 at 12:23:15. 
2% Schedule task XKE at 12:00, reschedule it every six minutes, 
assign it a priority of 99, and execute it in partition "XYZ". 
3. Schedule task SCAN at 23:30, reschedule it every ten minutes, 
assign it a priority of 200. 
4. Schedule task XKE at 1:00, task 2402 at 1:30; (with a user 


identification code of [11l11.1]). 
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SYNCHRONIZE form of command 
The "Synchronize" form of the RUN command allows the operator’ to 
synchronize the scheduling of a task in terms of delta time from 
"clock unit synchronization", with the option to specify periodic 
rescheduling, run priority, and memory partition. 


FORMAT: 


RUNAtasknamed star timeA+time [options] ($) 


where: 
taskname is the name of the task being run 
startime is the synchronization clock unit as follows: 
H = synchronize on the next hour. 
M = synchronize on the next minute. 
S = synchronize on the next second. 
T = synchronize on the next tick. 
time is the delta time increment that is added to. the 
synchronization clock unit yielding the actual 
start time. Time is expressed as nH, nM, nS, or 
nT where n is the number of hours, minutes, 
seconds, or ticks. 
options are any of the following: 
/RSI = rescheduling interval expressed as nH, 
nM, nS, or nT 
/PRI = priority number 
/PAR = partition name 
/UIC = [user identification code] 
EXAMPLES: 


MCR>RUN NK111 H+10M(S) 
MCR>RUN NK111 S+10M/PRI=10,240Z M+0S/RSI=15S/PRI=90 ($) 
In the example above the requests are to: 


nee Synchronize task NK111, schedule for 10 minutes after the next 
hour. 


2s Synchronize task NK111, schedule for 10 minutes after the next 
second, assign it a priority of 10; Synchronize task 2402, 
schedule it for 0 seconds after the next minute, rescheduling it 
every 15 seconds, and assign it a priority of 90. 
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6.23 SAVE COMMAND (SAVE) 


WARNING 


The SAVE command should be executed only 
when the system is quiescent. 


FUNCTION: 


THE SAVE command is used to record the core image of an RSX-11D 
system on the disk from which it was originally bootstrapped, so 
that a bootstrap can reload it and start up the system. 


FORMAT: 
SAV[E]A [/switch] 
where: 
/switch is one of the following optional switches: 
/MOU=dev: [dev:...:dev:] 


This switch is used to allow the system 
to be saved with the specified devices 
mounted. See Technical Note 3. 


/LOG=TTn: [TTn:...:TTn: ] 


This switch is used to allow the’ system 
to be saved with the specified terminals 
logged on. 


/NO, /NOX, /NOT, /NOXT 


These switches all inhibit automatic 
memory expansion or truncation when the 
saved image is rebooted. Tf none of 
these switches is used, SAVE determines 
exactly how much memory exists and 
expands or truncates the highest 
partition in the system. 


NOTE 


If the user attempts to save a 
system that still has volumes 
mounted or terminals logged on, 
and the /MOU or /LOG switches 
have not been specified, the 
save will not occur. 
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EXAMPLE: 


1. 


MCR>SAVE 


In this example, the current status of the system is saved on the 
disk from which it was originally bootstrapped. System changes 
Made by the REDIRECT or other MCR commands are also saved with 
the system core image. 


MCR>SAVEA/MOU: DFO: 


In this example, the system is saved with DFO: mounted. 
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TECHNICAL NOTES 


Ls 


Because the SAVE command provides a copy of a completed 
system configuration, it must be used only when the system is 
quiescent. SAVE ensures that the system is oauiescent by 
searching the system data base for any of the follcwing 
conditions: 

‘ Mounted devices, 


Users logged onto terminals other than the one _ from 
which the SAVE command was issued, 


P Tasks with I/O in progress, 
Tasks being loaded or checkpointed, 


Shareable global areas being loaded or, in the case 
of read/write common areas, being recorded on disk, 


: Tasks loaded or fixed beyond the end of the SAVE 


file, 

é Shareable global areas including the read-only root 
of multiuser tasks loaded beyond the end of the save 
file. 


If any of these conditions is detected, SAVE issues an 
appropriate error message. 


The SAVE command will attempt to record (on the system 
device) all memory specified at SYSGEN time. If more memory 
exists than was declared at SYSGEN, only the declared memory 
will be saved. If, however, less memory exists than was 
declared at SYSGEN, only the amount that exists will be 
saved. For a PDP-11/70, no more than 124K will be saved. 


SAV will not permit the system to be saved with volumes 
mounted or terminals logged on, unless the appropriate /MOU 
or /LOG switches are specified. 


In the case where the /MOU switch is specified, for Files-1l 
volumes the user must take the following information into 
account: 


a. When a volume is mounted, volume control data is 
established in memory to reflect the volume's current 
file status. This data is updated with every file 
operation. 


b. When a volume is dismounted, the volume's control data is 
reset. 


c. If the user selects to save the system with volumes 
mounted, the volume control data for each mounted volume 
is saved reflecting the current status of the volume. It 
is imperative that no file activity occur on the volume 
between the time the system was saved, and the next 
bootstrapping of the system. Otherwise, the integrity of 
the volume will be destroyed. 
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dad. When the system is re~bootstrapped, the status of the 
volume must be exactly the same as it was when the system 
was saved, or the integrity of the volume will be 
destroyed on the very first file operation. 


NOTE 


After the system is re-bootstrapped, and _ before 
any file activity has occurred, the user can 
execute the following commands to ensure the 
integrity of any volume: 


MCR>DMO dev: 
MCR>MOU dev: 


This will reset the volume's control data _ to 
reflect the current volume status. 


In the case where the /LOG switch is specified when the 
system is re-bootstrapped, the specified terminals are 
automatically logged on having the same UIC and privilege 
they had when the system was saved. 


When a saved system is rebooted or restarted, the system is 
expanded or truncated automatically to the amount of physical 
memory available unless the /NOXT switch was used when the 
system was saved. 


Because SAVE is active when a save is performed, it is active 
when the reboot/restart occurs. Tt is, in fact, the task 
SAVE that restarts an RSX-11D system and performs the memory 
size calculations. 


To expand the system, SAVE determines how much _ physical 
memory responds by testing memory in 4K word increments on a 
PDP-11/40, 45, or 50 or by reading the memory size register 
on PDP-11/70. If the address at the top of memory is greater 
than that at the last save, or at system generation if no 
save was performed, SAVE performs the following steps: 


Increases the size of the last (highest addressed) 
partition, 


! Adjusts the hole pointer, 


Prints a explanatory message on the terminal from 
which the SAV was initiated. 


If the actual memory is less than the amount contained in the 
save file, SAVE attempts to truncate one or more partitions 
starting from the highest end of memory. Truncation fails 
and an appropriate message is printed under the following 
circumstances: 


3 Any occupied partition size reduces to zero, 


* Any truncation occurs in an occupied user-controlled 
partition, 


PRIVILEGED USER COMMANDS 


Truncation in a system-controlled partition is_ so 
extensive that a previous occupied area of memory 
does not exist. 


In summary, unoccupied partitions can be truncated to size 
zero. Unoccupied parts of system-controlled partitions also 
can be truncated. Successful truncation results’ in a 
descriptive message printed at the terminal. 


Irrespective of any previous memory expansion or truncation, 
the save file is always the length specified at system 
generation and only that amount of memory is_ saved. This 
fact is the reason for the checking described in technical 
note 1 on entities loaded beyond the end of the save file. 


Chapter 5 of the RSX-11D System Generation Reference Manual 


contains more details about SAVE. 
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SET 


6.24 SET COMMAND (SET) 
FUNCTION: 
The SET command provides the privileged user with a facility for 
changing the terminal default UIC, the MCR timeout, the 
terminal's characteristics and privileges, for setting or 
clearing output spooling on a device and for controlling cache 
memory on PDP~-11/70. 
FORMAT: 
SETA [/keyword(s) ] 
where: 
/keyword is one or more optional keywords which, when 
specified, alter or set the default values they 
represent. The following keyword options are 


provided: 

/UIC=[{group ,member ] 
This option allows the user to change the 
therminal default UIC to the one specified to 
the right of the equal sign(=). 
Example: /UIC=[200,200] 

/TMO=nnnnn 
This option allows the user to change the MCR 
timeout value. The number nnnnn is a decimal 
value (any number up to 32767) representing 
the number of seconds MCR is to wait for a 
command before timing out. 


Example: /TMO=90 


This option defines the specified device(s) 
as having LA30S characteristics. 


Example: /LA30S=TT1:TT2: 
/LA30P=dev: [dev:...:dev:] 


This option defines the specified device(s) 
as having LA30P characteristics. 


Example: /LA30P=TT1:TT2: 


This option defines the specified device(s) 
as having KSR33 characteristics. 
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Example: /KSR33=TT1:TT2: 


This option defines the specified device(s) 
as privileged terminal device(s). 


Example: /PRV=TT1:TT2: 
/SLV=dev: [dev:....:dev:] 


This option defines the specified device(s) 
as slave terminal device(s). 


Example: /SLV=TT1:TT2: 


This option defines the specified device(s) 
aS nonprivileged terminal device(s). 


Example: /-PRV=TT1:TT2: 


This option defines the specified device(s) 
as nonslave terminal device(s). 


Example: /-SLV=TT1:TT2: 


This option defines the specified device(s) 
as being available to the output despooler 
for the spooling of spooled output files. 


Example: /SP=LP:TT1: 


This option defines the specified device(s) 
as no longer being available to the output 
despooler for the spooling of output files. 


Example: /-SP=TT1:TT2: 


This option defines a terminal(s) as having 
intermediate buffering. 


Example: /INB=TT3: 


This option discontinues intermediate 
buffering on the specified terminal(s). 


/CAC=n 


This option specifies the number of parity 


PRIVILEGED USER COMMANDS 


errors that can occur in a PDP-11/70 cache 
group in one minute before the Executive 
turns the group off. The value n can be from 
1 to 32,767 (decimal). The default value for 
n is 50. Parity error handling is discussed 
in the RSX-11D System Manager's Guide. 
/CAC=ONn 
This options allows the user to turn on a 
PDP-11/70 cache memory group that had 
previously been turned off. The value n 
indicates the number of the group. 
/CAC=OFn 
This option allows the user to turn off a 
PDP-11/70 cache memory group that is on. The 
value n indicates the number of the group. 
EXAMPLE: 
bie MCR>SET /UIC=[20, 20] /TMO=90/LA30S=TT1:TT2: 
In this example, the following actions are performed: 
a. The system UIC is set to [20,20]. 
b. The MCR timeout is set to 90 seconds. 
c. TTl: and TT2: are defined as having LA30S characteristics. 
2% MCR>SET /LA30S=TT1:TT2:TT3:/PRV=TT1:TT2:/SP=TT3: 


In this example, the following actions are performed. 


a. TT1l:, TT2:, and tTT3: are defined as having LA30S 
characteristics. 


b. Tl: and TT2: are defined as being privileged terminals. 


c. TT3: is made available to the output despooler for’ the 
spooling of output files. 
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TIME 


6.25 TIME COMMAND (TIM) 


FUNCTION: 


The Time command (TIM) allows the operator to list the time and 
date, or to alter the time and date values in the system clock 
calendar. 


FORMAT: 
TIM[E]A[time] A [date] 
where: 
time is specified in the format hour:minute:second 


date is specified in the format month/day/year 


NOTE 


If the TIME command is executed without parameters, the 
time and date that the system is currently running under 
will be listed. Also, if either or both of the 
parameters (time Or date) are specified, the 
corresponding field in the system will be altered to the 
value specified by the parameter. 


EXAMPLE: 
ce MCR>TIM 9:10:20 3/21/75 


In this example the time and date in the system clock calendar 
are changed to 9:10:20 and 3/21/75, respectively. 
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USER FILE DIRECTORY 


6.26 USER FILE DIRECTORY COMMAND (UFD) 


FUNCTION: 


The User File Directory command (UFD) creates a user file 
directory (UFD) on the specified volume and enters its file name 
into the master file directory (MFD). The UFD command accepts 
the [group,owner] number as both the UFD name and the file 
owners' UIC. 


FORMAT: 


UFDAdevice: [uic] [/switch] 


where: 
device: specifies the device that contains the volume to 
be acted upon. 
[uic] is the UIC of the UFD being created. 
NOTE 
The brackets which enclose the UIC are a 
required part of the parameter. 
/switch is one or more of the optional UFD switches 
described in Table 6-4. 
EXAMPLE: 


MCR>UFD DK1:[1,1]/ALLOC=100. 


In the example above, the request creates the UFD on disk device 
DK1 with the UIC [1,1] as the directory name; space is allocated 
for 100 directory entries. 
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Table 6-4 
UFD Switches 


DESCRIPTION 


This switch allows the owner of the directory to 
selectively permit access to his file. This 
switch is specified in the following format: 


SWITCH 


/PRO=[system,owner ,group,world] 


NOTE 


If the /PRO switch is not specified, the 
default file protection for the volume is 
used. 


/ALLOC This switch allows the owner of the directory to 
pre-allocate space for a specified number of 
directory entries. This switch is specified in 


the following format: 


/ALLOC=number-of-entries 


NOTE 


The number specified is assumed to be 
octal; the number may be specified with a 
trailing decimal point to represent a 
decimal value. The default is 32 octal. 
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UNFIX 


6.27 UNFIX COMMAND (UNF) 
FUNCTION: 


The Unfix command (UNF) allows the privileged user to free 
“Fixed" tasks from memory. 


FORMAT: 


UNF [IX]Ataskname [/TI=dev] [,taskname[/TI=dev],...] 


where: 

taskname is the name of the task being unfixed. 

/TI=dev is an optional switch (appended to the taskname) 
which allows the user to unfix any task in the 
system by specifying its TI (dev is the device 
mnemonic for the terminal corresponding to the TI 
under which the task is run). 

EXAMPLES: 


deg MCR>UNFIX XKE 
2% MCR>UNFIX 2402Z,NK111 
In the example above the requests: 
Ls Unfix task XKE, freeing it from memory; and, 


Zi Unfix task 2402 and Task NK11l. 
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UNLOAD 


6.28 UNLOAD COMMAND (UNL) 

FUNCTION: 
The UNLOAD command (UNL) causes the indicated device handler’ to 
exit, releasing its memory and causing the device to become 
inaccessible. 

FORMAT: 
UNL [OAD]Ahandler-name[: ] 

EXAMPLE: 

a MCR>UNLOAD LP 


In the example above the request unloads the line printer handler 
task. 


CHAPTER 7 


MAGNETIC TAPE VOLUMES 


The magnetic tape file system is a privileged task named MTAACP that 
provides file primitive services to FCS. The file system also uses an 
associated message task named F1IMSG that must be installed before a 
Magnetic tape volume can be mounted. 


The magnetic tape file system processes tape volumes that have _ been 
initialized through the INITVOL MCR function. The mounting and 
dismounting of a volume set is accomplished using the MOU and DMO MCR 
functions. 


Once a volume set is mounted, all volume or reel switching is 
transparent to the FCS level of the system. 


NOTE 


Tt is not necessary that all reels in a 
volume set be mounted on tape units 
simultaneously. 


7.1 INITIALIZING TAPE VOLUMES 


Initializing a magnetic tape volume is an important step in preparing 
a magnetic tape file system for use. All protection is at the volume 
level; therefore, to ensure proper use of volume sets, each volume 
must have a unigue volume identifier (label). The system manager 
should establish a method of assigning unigue volume labels’ and 
external identification. 


7.2 MOUNTING A VOLUME SET 


The MOU MCR command is used to mount the volume set. The following 
information should be kept in mind when mounting a volume set. 


1. Any number of tape units can be assigned to the volume set. 
All units must be compatible with each other (i.e., they must 
be either 9- or 7-track and 1600 or 800 bpi). 


2. All volume labels or only the first volume label in the set 
can be specified. See the examples below. 
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The number of volume labels specified in the MOUNT command 
affects the form of the operator mount message printed on the 
console. The system assigns relative volume numbers 
sequentially, starting with volume 1 and continuing through 
the list of volumes. The system assumes that the volumes, in 
the volume set are mounted physically as indicated in the MOU 
command. 


However, only relative volume 1 is verified at mount’ time; 
the verification of subsequent volumes is performed when 
these volumes are needed. 


3. Volumes produced by the magnetic tape file system of RSX-11D 
versions before version 6 (.FL300) are recognized 
automatically. The volumes produced under previous’ versions 
can only be read; they never can be written by the magnetic 
tape file system. 


The file set identifier, the file section number, and the _ file 
sequence number in 4HDR1 file labels are used by the file system to 
identify individual volumes in a set of volumes. 


The following are examples of MOU commands for volume sets. 


MCR>MOU MTO:1STVOL 1STVOL is the first volume of 
a volume set. It is mounted 
on MTO which is the unit on 
which all subsequent volumes 
are to be mounted. 


MCR>MOU MT(0,1): (1STVOL, 2NDVOL) 1STVOL is mounted on MTO. 
2NDVOL either is or will be 
mounted on MT1l. If 2NDVOL is 
not mounted when required, a 
message requesting operator 
action is printed on_ the 
console. 


7.3  DISMOUNTING THE VOLUME 


The DMO MCR command is used to dismount a volume set. The following 
information should be kept in mind when dismounting a volume set. 


1. All units assigned to the volume set are dismounted by the 
dismounting of any unit assigned to the volume set. 


2. Individual DISMOUNT COMPLETE messages are printed on_ the 
operator's console for each unit assigned to the volume set. 


3. All units are rewound and placed off-line unless the unit is 
currently off-line or rewinding. 


MAGNETIC TAPE VOLUMES 


7.4 OPERATOR INTERACTION WITH THE MAGNETIC TAPE FILE SYSTEM 


The magnetic tape file system issues messages to the console output 
device (CO) through the file system message task (F11MSG). These 
messages are requests for operator action. The operator is expected 
to perform the requested action for the specified tape unit and then 
place the unit on-line. 


The magnetic tape file system automatically detects that the requested 
unit has been placed on-line and restarts the process that was 
attempted before the request was issued. 
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NODE POOL STATUS PROGRAM 


The node pool status program (POOL) provides the privileged user with 
Sstatisitics about pool usage, and prints these statistics on the 
terminal. Once the POOL program is initiated, it executes every two 
seconds and prints the number of nodes available (unused) in the pool 
along with the largest contiguous amount of node space. All numbers 
(decimal) are in terms of 8-word nodes. 
Type the following command to cause POOL to execute: 

MCR>RUN POOL($) 
See Figure 8-1. 


To terminate POOL execution, the user must press CTRL C to obtain’ the 
MCR> prompt and enter the following command: 


RES POOL ($) 


This causes POOL to print summary information and exit. The summary 
information consists of the following: 


1. The largest contiguous amount of node space 
2. The smallest amount of node space 

3. The largest number of available nodes 

4. The smallest number of available nodes. 


This summary information is accumulated from the time POOL is 
initiated, to the time it is terminated. See Figure 8-l. 
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MCR>RUN POOL G) 


745 LARGEST 
759 LARGEST 
751 LARGEST 
753 LARGEST 
746 LARGEST 
742 LARGEST 


NODES 
NODES 
NODES 
NODES 
NODES 
NODES 


MCR>RES POOL (S$) 


NODES = 728 LARGEST HOLE = 113 
LARGEST NUMBER OF NODES 759 
SMALLEST NUMBER OF NODES 728 
LARGEST HOLE = 113 
SMALLEST HOLE = 113 


Figure 8-1 
Sample POOL Execution And Termination 
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MCR COMMAND SUMMARY AND ERROR MESSAGES 


A.1 MCR COMMAND SUMMARY 
ABORT (Non-privileged) 
ABOAtaskname[,taskname,...] 
ABORT (Privileged) 
ABOAtaskname [/TI=dev] 
ACTIVE TASK LIST (Non-Privileged) 
AcCTA[taskname] [/switch(es) ] 
Switches: 
/FU - Full listing 
/SH - Short listing 
/Til=dev - All tasks for specified TI 
ALTER PRIORITY (Privileged) 
ALTAtaskname [/TI=dev] /PRI=nnn[,taskname[/TI=dev]/PRI=nnn,...] 
BAD BLOCKS (Privileged) 
BADAdev: 
BOOTSTRAP (Privileged) 
Format 1 
BOO 
BOO> 
Format 2 
BOOAfilespec 
Format 3 


BOOA/WB 
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Format 4 
BOOAfilespec/WB 
BYE (Non-Privileged) 
BYE 
CANCEL (Privileged) 
CANAtaskname [/TI=dev] [,taskname[/TI=dev],...] 
CONTINUE (Non-Privileged) 
CONAtaskname[,taskname,...] 
DISABLE (Privileged) 
DISAtaskname[,taskname,...] 
DISMOUNT VOLUME (Non Privileged) 
DMOAdev: [volumelabel] [/UIC=[uic] ] [/LOCK] 
DISMOUNT VOLUME (Privileged) 


Same as non-privileged with this exception: only a privileged 
user is allowed to dismount the system volume. 


ENABLE (Privileged) 
ENAAtaskname[,taskname,...] 
FIX IN MEMORY (Privileged) 
FIXAtaskname [/TI=dev] [,taskname[/TI=dev],...] 
HELLO (Non-Privileged) 
HELA[uic] 
PASSWORD> 
INITIALIZE VOLUME (Privileged) 
INTIAdev: [volumelabel] [/keyword(s) ] 
Keywords 
/UIC=[uic] 


/PRO= [system,owner ,group,world] 
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/MXF=maximum number of files allowed on this volume 
/EXT=default file extension size in blocks 
/FPRO=[default file protection] 


/CHA=[characteristic word] 
ATCH or DCF or both 


/INF=number of file headers in file index 
/WIN=default window size for file 
/LRU=number of directories to keep accessed 
/DENS=magnetic tape density 

800 or 1600 
/INDX=index file position option 

BEG - beginning of volume 

MID - middle of volume 

END - end of volume 

BLK:nnn - logical block number 
/BAD=option (Initialization of bad block file) 


AUTO ~ use bad block data left on 
volume by BAD command task. 


MAN -—- enter bad blocks manually. 
INI>BAD=u[,n] 
INSTALL TASK (Privileged) 


INSAfilespec[/keyword(s)][,filespec[/keyword(s)],...] 


or 
INSA@indirect 

Keywords 

/PAR = partition name 


/PRI = priority-number (decimal) 
/TASK = taskname 


/PCOL = pool-limit (decimal) 


/UIC [uic] 


/ RUN 


[REM] (run-remove) 


/TIM = allowable run time expressed as nH, 
nS, nM, or nT. 


MCR COMMAND SUMMARY AND ERROR MESSAGES 


/ACC = non-owner access expressed as 


RO - read only 
RW - write only 
NA - no access (default) 


/Ul library file 


/CM 


common area 
/INC = task size increment 
LOAD (Privileged) 
LOAAhandler-name 
LOG COMMENT (Non-Privileged) 
LOGAcomment-line 
Or 
;Acomment-line 
Or 
!Acomment-line 
LOGICAL UNIT NUMBERS (Non-Privileged) 
LUNAtaskname[,taskname,...] 
MEMORY UNLOCK (Privileged) 
MEMAtaskname [/foptions][,taskname,...] 
Keywords 
/AL ~- all such tasks 
/TI = TTn - all tasks with this TI 
MOUNT VOLUME (Non-Privileged) 
MOUAdev:volumelabel [keyword (s) ] 
Keywords 
/CHA=[characteristics word] 


FOR - foreign volume 


ATCH - device can be attached exclusively 


by one task 
DCF - device control functions allowed 
/UNL (volumes index file is unlocked) 


/DENS = magnetic tape density 
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800 or 1600 
/ACP = taskname (file processor for the volume) 
/EXT = default file extend increment in blocks 


/FPRO = [default file protection] 
/LRU = number of directories to keep pre~-accessed 
/OVRFSID (override the set identifier check) 
/OVREXP (override the expiration date check) 
Format for Mounting Multi-Volume Magnetic Tape 
MOUAMT(n1[,n2,...,nn]):(labell[,label2,...,labeln]) [/keyword(s) } 
MOUNT (Privileged) 
MOU Adev:volumelabel [/keyword(s) ] 
Keywords 
All of the above-mentioned keywords, plus the following: 
/UIC =[uic] 
/OVR (override the volume label check) 
/PRO = [system,owner ,group,world] 
OPEN REGISTER (Privileged) 
OPEAmemory address[+ or -n] [/options] 
Options 
/TASK = taskname[/TI=dev] 
/PAR = partition name 
/KNL (Specifies kernel virtual address) 
OPERATE (Non-Privileged) 
OPRAdev:/switch[,dev:/switch,...] 
Switches 
/SP - Start printing 
/AB - Abort printing 
/ST ~ Stop printing 
/RS - Resume printing 


/RS:T ~ Resume printing from last 
encountered form feed. 
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/RS:TOF — Resume printing from top-of-file 


OPERATE (Privileged) 


OPRAdev:/switch[,dev:/switch,...,dev:/switch] 


Switches 


All of the above mentioned switches plus the following: 


/CHG - Change forms 


/FOz:n - Set the form type to n 


/RE ~ Recycle all active orders and 
requeue them as inactive 


PASSWORD (Non-Privileged) 


PWDA[ufd] 


PASSWORD>password 


PASSWORD (Privileged) 


Same as non-privileged with this exception; the privileged 
can change the password for any UFD on any volume not protected 


against system 


access. 


QUEUE (Non-Privileged) 


Queue a File For Printing 


QUEA[dev:=]infile-l[,infile-2,...,infile-n] [/switch(es) ] 


QUEA@indirect 
Switches 


/PR:nnn - 


/FO:n - 
/CO:nn - 
/DE ~ 


/TE = 


or 


Set the priority of output selection to 
(default /PR:50) 


Set form type to n (default /FO:0) 
Set number of copies to nn (default /CO:1) 
Delete file after printing (default /-DE) 


Test for forms alignment 


List Elements in Queue 


QUEA/LI 


Kill (Delete) Elements in Queue 


QUEA/KI:seaq[:seq:...:seq] 


Modify Elements in Queue 


user 


nnn 
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QUEA[dev:=]/MO:seq[:seq:...:seq] [/switch (es) ] 
Switches 
/PR:nn - Change priority to nnn. 
/FOrn ~ Change form type ton. 
/COz:nn - Change number of copies to n. 
/DE - Change delete/preserve indicator to 


(default /-DE) 
REASSIGN (Privileged) 
REAAtasknameAlunlistAdev: 
REDIRECT (Privileged) 
REDAnew-dev : =old-dev: 
REMOVE (Privileged) 
REMAnamel [/switch] [,name2[/switch],...] 
Or 
REMA@indirect 
RESUME (Non~-Privileged) 
RESAtaskname [/TI=dev] [,taskname[/TI=dev],...] 
RUN (Non-Privileged) 
RUNAf ilename ($) 
or 
RUNA$ filename (S) 
RUN (Privileged) 
(Request) 
RUN Ataskname [/option] [, taskname[/option],...] (8) 
Options 
/PRI=priority number (decimal) 
/PAR=partition name 
/UIC=[user identification code] 
(Execute) 


RUNAtaskname/MEM[/option] [,taskname/MEM[/option],...] (S) 
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Options 


/PRI=priority number (decimal) 
/PAR=partition name 
/UIC=[user identification code] 
(Run) 
RUNAtasknameAt ime [/options] [,tasknameAtime [/options],...]G) 
Options | 


/RSI=reschedule interval expressed as 
nH, nM, nS, or nT 


/PRI=priority number (decimal) 

/PAR=partition name 

/UIC=[user identification code] 
(Schedule) 


RUNAtasknameAt ime [/opt ions] ($) 


Options 
/RSI = reschedule interval expressed 
as nH, nM, nS, or nT 
/PRI = priority number (decimal) 
/PAR = partition name 
/UIC = [user identification code] 
(Synchronize) 


RUNAtasknameAstartimeA+time[/opt ions] ($) 


Options 


/RSI rescheduling interval expressed as 


nH, nM, nS, or nT 


/PRI = priority number (decimal) 

/PAR = partition name 

/UIC = [user identification code] 

/TIM = timeout limits for accountable tasks 


SAVE (Privileged) 
SAVA[/switch] 
Switches 


/MOU=dev: [dev:...dev:] - save system with dev: mounted 
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/LOG=TTn: [TTn:...:TTn:] 


—- save system with specified 


terminals logged on. 


/NOXT ~ inhibit memory expansion/truncation on reboot. 


SET (Privileged) 


SETA[/keyword(s) ] 


Keywords 


/UIC=[group,member ] 


/TMO=nnnnn 

/UA30S=dev: [dev:...:dev 
/LA30P=dev: [dév:...:dev 
/KSR33=dev: [dev:...:dev 
/PRV=dev: [dev:...:dev:] 


/SLV=dev: [dev:...:dev:] 


/~PRV=dev: [dev:...:dev:] 


/~-~INB=dev: [dev:...:dev:] 


SYS (Non-Privileged) 


SYSA[/switch[:opt]] 


Switches 

/ATL - 
/MRL[:opt] - 
/CKQ az 
/GCO - 


Lists names of Libraries and comman 


change MCR timeout value to 
nnnnn. 

device has LA30S 
characteristics 

device has LA30P 
characteristics 

device | has KSR33 
characteristics 

device is defined as a 
privileged terminal device 
device is defined as a_e slave 
terminal device 

device is defined as a 


non-privileged terminal device 


device is defined as a 
non-sSslave terminal device 
devices available to the 
Output Despooler 


devices no longer available to 
the Output Despooler 
device is defined as having 
intermediate buffering. 


device is defined 
intermediate 
recended. 


as haveing 


buffering 


List names of tasks in the active task list 
List names of tasks in memory reguired list 


List name of task in the clock que 


area in 


TIME (Non-privileged) 


TIM 
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/TRQ[:opt] 


/CTL[:opt] 


/FTL 


/SRQ 


/ASQ 


/SGA 


/BRF 
/FUL 
/TAS 
/DEV 
/PAR 


/COM 


TIME (Privileged) 


TIMA[time]A [date] 


the global 


List names 
request que 


List name o 
list 


List names 


List names 
for them 


List names 
queued for 


List names 
to which ea 


Lists names 
Lists all t 


Same as TAS 


common directory 


of tasks with entries in the 1/0 
ue 


f tasks in the checkpointable task 


of tasks in the fixed tasks list 
of tasks that have sends queued 
of tasks in the ATL that have ASTs 
them 


of tasks in the STD and the  SGAs 
ch is bound 


of tasks in the ATL, MRL, or CKQ 
he above except /SGA 


command 


Same as DEV command 


Same as PAR 


Same as COM 


USER FILE DIRECTORY (Privileged) 


UFDAdev: [uic] [/switch] 


Switches 


command 


command 


/PRO=[system,owner ,group,world] 


/ALLOC=number-of-entries 


UNFIX (Privileged) 


UNFAtaskname [/TI=dev] [,taskname[/TI=dev],...] 


UNLOAD (Privileged) 


UNLAhandler-name[: ] 


WHO (Non-Privileged) 


WHO 
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A.2 MCR ERROR MESSAGES 


The error messages in this appendix are listed in alphabetic order by 


issuing task. The only exceptions are the messages issued by the task 
MCRERR. Tt prints the user-entered command that caused the error and 


then, on the following line, prints the error message. Messages with 
no 3-letter prefix can be identified as coming from MCRERR. These 
messages are presented in Section A.2.1 
ACT -- INVALID ADDRESS IN A.TI 

The active task list contains a TI that has an invalid address. 


Notify the DEC software specialist. 


ACT -- INVALID DEVICE 


The device mnemonic, specified by the user, is either invalid or 
specified in a nonstandard format. 


ACT -- INVALID SWITCH 
The user specified a switch that ACT does not recognize. Either 
the switch is not an ACT switch, or it was specified in the wrong 
format. 

ACT -- INVALID SWITCH COMBINATION 


The user specified switches that are mutually exclusive; see the 
description of ACT in Chapter 5 to determine which switches can 
be used together. 

ACT -- INVALID TASK NAME 
The user specified a task name that either contains more than 6 
alphanumeric characters or one that contains a non-alphanumeric 
character. 

ACT -- NO TASKS ACTIVE ON TERMINAL 

or 


ACT -- TASK NOT ACTIVE 


Self-explanatory. 


ACT -- TOO MANY TASKS FOR BUFFER 


ACT can only process a maximum of 10 active tasks, and the active 
task list contains more than 10. Only the first 10 tasks in the 
queue are listed at the user terminal. 


To make ACT handle more than 10 active tasks, the system manager 
must task build ACT to accommodate more tasks. This is 
accomplished by modifying ACT's size, and the size of its 
processing buffer (MAXTSK). 
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ACT -- THE /FU SWITCH REQUIRES A TASK NAME 
Self-explanatory. 
BAD -- BAD BLOCK FILE OVERFLOW 
More than 102 groups of bad blocks (each group consisting of from 
1 to 256 bad blocks) were detected. The disk pack is defective. 
BAD -- BLOCK 0 BAD - DO NOT USE AS SYSTEM DEVICE 
This is a warning message; it requires no user action. BAD has 
terminated normally; and all bad block information is available 
for INITVOL. 
BAD -- DEVICE HANDLER MISSING 
The reguired disk handler task is not loaded. 
Load the required handler and retry the command. 
BAD -- DEVICE NOT IN SYSTEM 
The specified device was not included as a usable device when the 
system was generated. That is, there is no PUD entry for the 
device. The user most likely typed the device mnemonic 
incorrectly. 
BAD -- DISK ATTACH FATLED 
The specified disk is currently attached by another task. 
Wait until the attaching task releases the disk, then retry the 
command. 
NOTE 
If the specified disk is currently 
attached by another task, there is a 
good chance the user specified the wrong 
device mnemonic. 
BAD -- DISK ERROR 


An unaccountable error occurred on the specified device; most 
likely a hardware error. 


Insure that the device is properly cycled up and on line, then 
retry the command. If the error reoccurs, notify field service. 
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-- DISK MOUNTED 

The specified disk is logically mounted. That is, a MOU command 
was issued for the device. BAD cannot process bad blocks for a 
logically mounted disk. 


Execute the DMO command for the device, then retry the command. 


-- DISK NOT READY 


The specified disk device is inaccessible; probably due to a 
hardware error. 


Insure that the device is properly cycled up and on-line, then 
retry the command. If the error reoccurs, notify field service. 
-- DISK WRITE LOCKED 

The specified disk device is inaccessible for write operations. 


Set the write enable switch and retry the command. 


-- FAILED TO READ MCR COMMAND BUFFER 

BAD failed to obtain the command line with which it was’ invoked. 
This will occur if BAD is’ invoked using the RUN command, as 
opposed to the prescribed method. 

Retry the command using the prescribed format. Tf the failure 
reoccurs, notify the DEC software specialist. 

-- FAILED TO WRITE BAD BLOCK FILE 

Either an error occurred when BAD attempted to write the _ bad 
block information, or the last 256 blocks of the disk are 
unusable. 

-- ILLEGAL DEVICE 

The device mnemonic, specified by the user, is either invalid or 
specified in a non-standard format. 
-~ SYNTAX ERROR 

Self-explanatory; refer to the command description for the 
correct syntax. 
-- ASSIGN LUN ERROR -- CODE -nn 

The system is unable to assign a LUN to the device being booted. 


The reason for the failure is determined by -nn, where -nn is a 
system standard error code. See Appendix N. 
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~~ CANNOT FIND SYSTEM DEVICE PUD 

The system device (SY) PUD cannot be found. This will occur if 
SY was redirected to itself, or if the PUD entry itself is 
corrupted. 

Redirect SY to a valid system device, then retry the command. If 
the error reoccurs, call the DEC software specialist. 


-- COMMAND I/O ERROR CODE, CODE = -nn 


The TTY handler is unable to obtain a command line from the’ user 
terminal. 


Notify the DEC software specialist. 


-- COMMAND SYNTAX ERROR 

Self-explanatory; refer to the command description for the 
correct syntax. 

-- ERROR CLOSING FILE filename CODE = -nn 

The file system is unable to close the specified file. The 
reason for the failure is determined by -nn, where -nn is a 
system standard error code. See Appendix N. 


~- FILE NOT AN RSX IMAGE 


Self-explanatory. 


-- FILE NOT CONTIGUOUS 


The file is either corrupted, or not an RSX system image file. 


-- GET LUN ERROR -- CODE = -nn 

The system is unable to get a LUN for the device being booted. 
The reason for the error is determined by -nn, where -nn is a 
system standard error code. See Appendix N. 


-~- INDIRECT COMMAND SYNTAX ERROR 


The user specified an indirect command file specifier in a format 
that does not conform to syntax rules. 


Refer to the command description for the correct syntax. 
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-- INDIRECT FILE DEPTH EXCEEDED 

The indirect command file, specified by the user, has an indirect 
command file specification as one of its commands. BOO can only 
process one indirect command file at a time. 

Recreate the indirect command file, or enter the commands 
manually. 
-- INDIRECT FILE OPEN FAILURE, CODE = -nn 

BOO is unable to open the specified indirect command file. The 
reason for the failure is determined by -nn, where -nn is a 
system standard error code. See Appendix N. 

-- INVALID SWITCH 

The user specified a un-recognizable switch. The only switch 
recognized by BOO is /WB. 
-- ILLEGAL DEVICE/VOLUME 

The device mnemonic, specified by the user, does not conform _ to 
device syntax. 
-- ILLEGAL DEVICE/UNIT NUMBER 

Either the device mnemonic is illegal; not recognized by the 
system, or the unit number exceeds the prescribed range for the 
device. 

-- ILLEGAL FILENAME 

The user specified a file name that either contains a 
non-alphanumeric character, or one that is greater than 9 
alphanumeric characters in length. 


-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


-- ILLEGAL GET COMMAND LINE ERROR, CODE -nn 

The system, while processing a get command line directive, 
encountered an unexplainable error condition. Either the system 
software is corrupted, or the hardware has failed. -nn is. the 
get command line error code. 


Notify the DEC software specialist. 
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~~ ILLEGAL UIC 

The UFD specified by the user is either illegally formatted or 
nonexistent. 

-~— I/O ERROR RSX IMAGE FILE filename, CODE = -nn 

The file system encountered an error while reading the specified 
file. The reason for the failure is determined by -nn, where ~-nn 
is a system standard error code. See Appendix N. 
-- I/O ERROR (CODE = -nn) WRITING BLOCK 0 

Probable hardware error; the QIO issued by BOO was valid, but 
the write to block 0 failed. The reason for the failure is 
determined by -nn, where -nn is a system standard error. code. 
See Appendix N. 
-- NO WILD CARDS ALLOWED 


Self-explanatory. 


-- NOT BOOTABLE DEVICE 


The specified device is not a mass storage device. 


~~ ONLY ONE FILESPEC (OUTPUT) ALLOWED 


Self-explanatory. 


-- OPEN FAILURE FILE filename, CODE = -nn 

BOO failed to open the specified file. The reason for the 
failure is determined by -nn, where -nn is a system standard 
error code. See Appendix N. 

-- QIO FAILURE (CODE = -nn) WRITING BLOCK 0 

A QIO issued by BOO was rejected; BOO may be corrupted. The 
reason for the failure is determined by ~-nn, where -nn is a 
system standard error code. See Appendix N. 


~~ SYSTEM IS NOT QUIESCENT 


The user attempted to execute BOO while tasks were still active 
in the system. 


Execute ACT to determine which tasks remain active. Terminate 


the active tasks or wait for them to finish executing, then retry 
the BOO command. 
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CON -- COMMAND SYNTAX ERROR 
Self-explanatory; refer to the command description for’ the 
correct syntax. 

CON -- ILLEGAL ERROR/SEVERITY CODE nl n2 n3 
CON failed in its attempt to issue a message to the user 
terminal. nl contains the value in Rl at the time of the 
failure; n2 contains the value in  R2; and n3 contains’ the 
return address after calling the error message routine. 


NOTE 


The high order byte in Rl reflects the severity code 
between 0 and 2. 


The low order byte in Rl reflects the error message CON 
was trying to issue. 


Notify the DEC software specialist. 


CON -- TASK taskname NOT ACTIVE 
Or 
CON -- TASK taskname NOT IS SYSTEM 


Self-explanatory. 


CON -- UNABLE TO READ MCR COMMAND LINE 
CON failed to obtain the command line with which it was’ invoked. 
This will occur if CON is invoked using the RUN command, as 
opposed to the prescribed method. 


Retry the command using the prescribed format. Tf the failure 
reoccurs, notify the DEC software specialist. 


DMO -- COMMAND I/O ERROR 


The DMO task is unable to obtain a command line from the user 
terminal. 


Notify the DEC software specialist. 


DMO -- DEVICE NOT IN SYSTEM 


The user specified a device that was not included as a eusab’e 
device when the system was generated. That is, there is no PUD 
entry for the device. The user most likely typed the device 
mnemonic incorrectly. . 
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-- DEVICE NOT MOUNTABLE 

The user specified a device that cannot be mounted; e.g., card 
reader. 

-- HANDLER NOT RESIDENT 


The user specified a device for which the appropriate device 
handler is not resident. 


Load the required device handler task and retry the command. 


-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


~~ INVALID UIC 


The UIC specification, entered by the user, either does not match 
the volume's UIC; or it was entered in the wrong format. 
-- INVALID VOLUME LABEL 

The volume label, specified by the user, does not match. the 
volume's label. 
-- SYNTAX ERROR 

Self-explanatory; refer to the command description for the 
correct syntax. 
-- VOLUME BUSY - TRY AGAIN 

There are open files on the volume. 


Wait for the files to be properly closed, then retry the command. 


-~ VOLUME NOT MOUNTED 


Self-explanatory. 


-~- DIRECTIVE FAILURE 
An undefinable error occurred during the execution of HEL. 


Retry the command. If the error reoccurs, notify the DEC 
software specialist. 
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-- ILLEGAL PASSWORD 

System access is denied. The specified password does not match 
the password stored in the requested UFD. 
-~- READ FAILURE ON DIRECTORY ENTRY 

Either the specified UIC does not correspond to a UFD on _ the 
system device. Either the system device is not mounted or the 


hardware has failed. 


Notify the system manager. 


== SYNTAX ERROR 

Self-explanatory; refer to the command description for’ the 
correct syntax. 
-- ALLOCATION FOR SYS FILE EXCEEDS VOLUME LIMIT 

Either the user specified /INDX=BLK:n where the value for n_ was 
too high; or the user specified /INDX=END and the value 


specified in /INF=n was too large. 


Retry the command with a lower value specified. 


-- BAD BLOCK HEADER I/O ERROR 


INI is unable to retrieve the bad block data area from the 
specified disk volume. 


Retry the command. Tf the problem persists, perform the 
following: 


1. Rerun BAD 

2. Rerun INI with /BAD=[AUTO] specified. 

If the problem still persists, the hardware has’ failed. Notify 
field service. 
-~- BAD BLOCK FILE FULL - TASK ABORTED 

Either the bad block file was full from a previous BAD execution, 


or the user specified more bad blocks than the bad blocks file is 
able to store. The disk is not usable. 


-- BLOCK(S) EXCEED VOLUME LIMIT 


The user specified a range of bad blocks that exceed the range of 
blocks available on the desired volume. 
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INI --~ BOOT BLOCK WRITE ERROR 


INI 


INI 


INT 


INI 


INI 


INI 


INI has failed in its attempt to format the disks bootstrap 
block. One of the following conditions exists: 


1. The disk device is off line 
2. The bootstrap block (block 0) is bad 
3. The device is write locked 


4. The hardware has failed. 


~- CHECKPOINT FILE HEADER I/O ERROR 


INI is unable to write the volume's checkpoint file header area. 
One of the following conditions exists: 


1. The device is off line 
2. The device is not write enabled 
3. The volume has a bad block 


4. The hardware has failed. 


-- DATA ERROR 
The user entered bad block data in an incorrect format. 


Re-enter the command using the correct format. 


-~- DEVICE NOT IN SYSTEM 

The specified device was not included as a usable device when the 
system was generated. That is, there is no PUD entry for the 
device. The user most likely typed the device mnemonic 
incorrectly. 
-- DEVICE NOT READY 


The requested device is not completely cycled up. 


Wait for the device to become ready, then retry the command. 


--~ DEVICE WRITE LOCKED 


Set the device write enable switch, then retry the command. 
--~ DUPLICATE BLOCK(S) FOUND 


The user specified bad block data for blocks that already appear 
in the bad blocks file. 
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INI -- FILE CORRUPT --~ DATA IGNORED 
The volume's bad block data is inconsistent. 


Re-execute BAD, then retry the INI command. 


INI -- HANDLER NOT RESTIDENT 
The required device handler is not resident. 


Load the required device handler and retry the command. 


INI ~~ HOME BLOCK ALLOCATE WRITE ERROR 


INI has failed in its attempt to allocate space for the volume's 
home block. One of the following conditions exists: 


1. The device is off line 
2. The device is not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 


INI -~- HOME BLOCK WRITE ERROR 


INI has failed in its attempt to write the volume's home block 
data. One of the following conditions exists. 


l. The device is off line 
2. The device is not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 


INI -- INDEX FILE BIT MAP T/O ERROR 


INI has failed in its attempt to write the volume's' index bit 
map. One of the following conditions exists: 


1. The device is off line 
2. The device is not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 
INI -- INDEX FILE HEADER I/O ERROR 


INI has failed in its attempt to write the index file header. 
One of the following conditions exists: 
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1. The device is off l 


ine 


2. The device is not write enabled 


3. The volume has bad blocks 


4. The hardware has failed. 


-~- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


or 
-- ILLEGAL KEYWORD VALUE 


Self-explanatory. 


-~- ILLEGAL UIC 


The user specified a UIC that either 
syntax, or is not in the range of valid UICs. 


-- MAGTAPE DEVICE ERROR 


The specified magnetic 
the following reasons: 


tape device cannot be accessed for one 


.1. The device is off line 


2. The device is not write enabled 


3. The hardware has failed. 


~- MAGTAPE LABEL MUST BE SPECIFIED 


Self-explanatory. 


~- MAGTAPE WRITE ERROR 


does not 


conform 


to 


UIC 


of 


INI is unable to initialize a magnetic tape volume for one of the 


following reasons: 


1. The device is off 1 


2. The device is write protected 


3. The hardware has failed. 


INI is unable to write 
following reasons: 


ine 


the 


MFD 
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1. The device is off line 
2. The device is not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 


INI -- MFD WRITE ERROR 


INI is unable to write the MFD file for one of the _ following 
reasons: 


1. The device is off line 
2. The device iS not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 


INI -- NOT FILES-11 DEVICE 


Self-explanatory. 


INI -- NULL FILE HEADER I/O ERROR 


The hardware has failed. Notify field service. 


INI -- STORAGE BIT MAP FILE HEADER I/O ERROR 


INI is unable to format the bit map for one of the _ following 
reasons: 


1. The device is off line 
2. The device is not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 


INI -- SYNTAX ERROR 


Self-explanatory; refer to the command description for’ the 
correct syntax. 


INI -- VOLUME MOUNTED 
INI cannot process a logically mounted volume. 
If the device mnemonic was correctly specified, execute DMO to 


dismount the volume, then retry the command; otherwise, retry 
the command with the device mnemonic correctly specified. 
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or INV -- COMMAND I/O ERROR 
INI is unable to get a command line from the user terminal. 


Notify the DEC software specialist. 


or INV -- COMMAND SYNTAX ERROR 

Self-explanatory; refer to the command description for. the 
correct syntax. 

-- DATE MISMATCH GLOBAL AREA area-name FILE filename 


The task being installed is linked with a global area that is a 
different version than the one currently installed. 


Remove the current version; replace it with the latest version, 
then retry the command. 
-- FLAGWORD MISMATCH GLOBAL AREA area-name FILE filename 


Either the flag word field of the global area is corrupted, or 
the corresponding field in the task image is corrupted. 


Rebuild.either the offending task or global area, and retry the 
command. 
-- GLOBAL AREA ACCESS REQUEST VIOLATION FILE filename 


The task being installed is denied access to the specified global 
area. One of the following conditions exists: 


1. The task contains an illegal reference or link to the global 
area 


2. The global area is protected against access. 


Rebuild the task correctly and retry the command. 


-- GLOBAL AREA NAME ALREADY IN USE 


The user attempted to install a global area whose name matches 
one that is already installed. 


Either remove the global area already installed, or rebuild the 
new one, giving it a new name. 

or INV -- UNKNOWN DEVICE dev: FILE filename 
A device assigned to a LUN at task build time is not one that was 
generated into the system. This is a diagnostic message; the 


task image was successfully installed. The user must, however, 
reassign the LUN to a valid device before running the task. 
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INS or INV -- ILLEGAL DEVICE/VOLUME dev: 
The user specified a device that is not recognized by the system. 
It is either an illegal device, or the device was improperly 
specified. 

INS or INV -- ILLEGAL DIRECTORY 


The user specified a UFD in a format that does not conform to 
syntax rules. 


INS or INV -~ ILLEGAL ERROR/SEVERITY CODE nl n2 n3 
INS failed in its attempt to issue a message to the user 
terminal. nl contains the value in Rl at the time of the 
failure; n2 contains the value in  R2; and n3 contains’ the 


return address after calling the error message routine. 


NOTE 


The high order byte in Rl reflects the severity code 
between 0 and 2. 


The low order byte in R1 reflects the error message CON 
was trying to issue. 


Notify the DEC software specialist. 


INS or INV -- ILLEGAL FILENAME filename 
The specified filename contains non-alphabetic characters, or it 
is more than 9 characters in length. 

INS or INV ~-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


INS or INV -- ILLEGAL GET COMMAND LINE ERROR CODE -nn 
The system, while processing a get command line directive, 
encountered an unexplainable error. Either the system software 
is corrupted, or the hardware has failed. -nn is the error 
return code. 


Notify the DEC software specialist. 


INS or INV -- ILLEGAL HEADER DATA FILE filename 
The task image header block is corrupted; the task is unusable. 


Rebuild the task; then retry the command. 


A-25 


INS 


INS 


INS 


INS 


INS 


INS 


INS 


INS 


MCR COMMAND SUMMARY AND ERROR MESSAGES 


or INV.-- ILLEGAL LABEL DATA FILE filename 
The task image contains inconsistent information; the file is 
corrupted and, therefore, unusable. 
Rebuild the task; then retry the command. 

-- ILLEGAL OPTION ON SHARABLE GLOBAL AREA filename 
The user specified the /INC keyword option for a sharable global 
area. 

Retry the command without the /INC switch specified. 

or INV -- ILLEGAL POOL LIMIT FILE filename 
The pool limit established in the task image file header is 
illegal; either file header is corrupted, or the value specified 
for the /POOL switch exceeds 255. 
Rebuild the task; then retry the command. 

or INV -- ILLEGAL PRIORITY FILE filename 
The task image file header is corrupted; the file is not usable. 
Rebuild the file; then retry the command. 

or INV -- ILLEGAL SWITCH 
The user specified a switch that INS does not recognize. Either 
the switch is not an INS switch, or it was specified in the wrong 
format. 

or INV -- ILLEGAL TASK STATUS WORD FILE filename 
The task status word of the task image file's header is 
corrupted; the file is not usable. 
Rebuild the file; then retry the command. 

or INV -- ILLEGAL UIC FILE filename 
Either the UIC in the task image file's header is corrupted, or 
the UIC specified in the INS command line is bad. 
Either rebuild the task and retry the command, or retry the 
command with the UIC correctly specified. 

or INV -- IMPROPER SIZE DATA FILE filename 


The task image file is corrupted. 


Rebuild the task, then retry the command. 
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INS or INV -- INDIRECT COMMAND SYNTAX ERROR 


The user entered an indirect command file specifier in a format 
that does not conform to syntax rules. 


Retry the command with the indirect command file correctly 
specified. 

INS or INV -- INDIRECT FILE DEPTH EXCEEDED 
The indirect command file, specified by the user, has an indirect 
command file specification as one of its commands. INS can only 
process one indirect file at a time. 
Recreate the originally specified indirect command file, 
replacing the erroneous command file specifier with the actual 
commands it represents. 


INS or INV -- INDIRECT FILE OPEN FAILURE filename 


The requested indirect command file cannot be located on_ the 
specified or implied device. 


Insure that the indirect file specifier was correctly entered, 
and retry the command. 
INS or INV -- I/O ERROR TASK IMAGE FILE 


INS encountered an error while processing the specified task 
image file. One of the following conditions exists: 


1. The device is off line 
2. The device is not write enabled 
3. The volume has bad blocks 


4. The hardware has failed. 


INS -—-- LENGTH MISMATCH GLOBAL AREA area-name FILE filename. 


Either the task image file's label block is corrupted, or the GCD 
in a global area is corrupted. 


Rebuild either the task image or global area, then retry the 
command. 


INS or INV -- MEMORY MAPPING CONFLICT FILE filename 


Either the task's memory mapping registers or memory limits are 
invalid. 


Rebuild the file, then retry the command. 
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INS or INV -- NO NODE AVAILABLE FOR FILE filename 


The system is saturated with active tasks; there are n 
nodes available to run INS. 


Either wait for pool nodes to become available, or noti 
system manager. 


INS or INV -- NO ROOM IN STD FOR NEW TASK taskname 


The number of allowable installed tasks, specified at 
generation, has been reached. The named task cannot be in 
until some of the previously installed tasks are removed. 
case of INV, the system data base or SGNI/INV hav 
corrupted. 


Notify the system manager, if using INS. Tf using INV, 
the DEC software specialist. 
INS or INV -- NON CONTIGUOUS TASK IMAGE FILE 


Either the file is not a task image file, or the f 
corrupted. 


Oo pool 


fy the 


system 
stalled 
In the 
e been 


notify 


ile is 


Either retry the command with the correct file specified; Or 


rebuild the task, then retry the command. 


INS or INV -- OPEN FAILURE FILE filename 


INS failed to open the specified task image file for an 
One of the following conditions exists: 


1. The requested file does not exist in the specified UFD 
2. The UFD does not exist 

3. The file is protected against write access 

4. The volume is not mounted 

5. The volume is off line 

6. The device is not write enabled 


7. ##The hardware has failed 


INS -- SHARABLE GLOBAL AREA HAS NO OWNING UIC filename 
All SGAs must be built or installed having a owning UIC. 
Either rebuild the SGA specifying a UIC, or retry the 
command with the /UIC switch specified. 

INS or INV -- SPECIFIED PARTITION IS TOO SMALL FILE filename 


Self-explanatory 
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-- STARTING APR MISMATCH GLOBAL AREA area-name FILE filename 


Either the APR field in the global area is corrupted, or _ the 
corresponding field in the task image is corrupted. 


Rebuild either the offending task image or global area and retry 
the command. 
Or INV -- TASK NAME ALREADY IN USE FILE filename 


The user is attempting to install a task whose name is assigned 
to a previously installed task. 


Either remove the previously installed task replacing it with 
this one, or assign a different name to this task via the /TASK 
keyword. 
-- TASK REQUIRES MORE THAN 7 GCD'S 


The specified task image is linked to more than 7 GCD'S. 


Rebuild the task changing the number of GCD'S to 7 or less. 


~- TICKS PER SECOND IN SCOM INVALID 
This is a system software problem; notify the DEC software 
specialist. 
or INV -- TIMEOUT SPECIFIED ON NON ACCOUNTABLE TASK 
Self-explanatory. This is a diagnostic message; the install was 
successfully completed. 
--~ UNDEFINED GLOBAL AREA area-name FILE filename 


The specified task is linked to a global area that has not been 
installed. 


Install the required global area, then retry the command. 


or INV -- UNDEFINED PARTITION FILE filename 


The user specified the /PAR switch either at task build time, or 
at install time. The specified partition does not exist. 


Either rebuild the task, or retry the INS command with the 
partition name correctly specified. 


Or INV -- UNKNOWN KEYWORD IDENTIFIER 


Self-explanatory. 
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-- WATCHDOG TIMER OVERFLOW 

The value specified in the /TIM switch exceeds 24 hours in hours, 
minutes, seconds, or ticks. 
-- CANNOT INSTALL GLOBAL REGIONS 

Sharable Global areas cannot be installed during SYSGEN phase 1. 
Defer installation until phase 2 or later. 
-- CANNOT INSTALL MU TASKS WITH RO AREAS 

The user is attempting to install a multi-user task that has a 
read only root, which cannot be done during phase 1 of system 
generation. Defer installation of these tasks until phase 2 or 
later. 
-~~ CANNOT INSTALL TASKS BOUND TO GLOBALS 

During phase one of SYSGEN, tasks that are bound to_- sharable 
global areas cannot be installed. Defer installation of these 
tasks until phase 2 or later. 
-~ CAN'T READ MCR COMMAND BUFFER 

LUN failed to obtain the command line with which it was’ invoked. 
This will occur if LUN is’ invoked using the RUN command, as 
opposed to the prescribed method. 

Retry the command using the prescribed format. If the failure 
reoccurs, notify the DEC software specialist. 


-- FATAL I/O ERROR 


The device, on which the specified task is installed, cannot be 
accessed. One of the following conditions exists: 


1. The requested file does not exist in the specified UFD 
2. The UFD does not exist 

3. The file is protected against write access 

4. The volume is not mounted 

5. The volume is off line 

6. The device is not write enabled 


7. The hardware has failed 
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-- NO LUN ASSIGNMENT 
or 
-- NO LUNS 


Self-explanatory. 


-- SYNTAX ERROR 

Self-explanatory; refer to the command description for the 
correct syntax. 

-- GET LINE ERROR 


MEM failed to obtain the command line with which it was’ invoked. 
This situation can occur if MEM is invoked using the RUN command. 


Retry the command by typing the following line. 
MCR>MEM options 


If the failure reoccurs, notify the DEC software specialist. 


~~ ILLEGAL SWITCH 

An illegal switch or a nonexistant device for TI= was’ specified, 
or a series of specifications were included with one or more 
tasknames omitted. 


Retry the command. 


-- PRIVILEGED USER FUNCTION ONLY 


Self-explanatory. 


-~ taskname SPECIFIED VERSION NOT LOCKED 


Either the task specified in the MEM command was not locked in 
memory or a typing error was made when typing the command. 


-- SYNTAX ERROR 


Self-explanatory. 


-- ACP TASK NOT INSTALLED 
Self-explanatory. Install task the desired ACP task and/or 


verify that the ACP task name was correctly specified, then retry 
the command. 
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-~- ALL UNITS MUST HAVE SAME NUMBER OF TRACKS 


All units dedicated to a magnetic tape volume set must be the 
same; that is, all 800 BPI or all 1600 BPI. 


Retry the command with the correct device types specified. 


-- BAD BLOCK ON DEVICE 

Either the hardware has failed, or there is an inconsistency with 
the medium; for example, a seven track tape on a nine track 
drive. 


~- COMMAND T/O ERROR 


The TTY handler is unable to obtain a command line from_ the 
user's terminal. 


Notify the DEC software specialist. 


-- DEVICE IS NOT MOUNTABLE 


Self-explanatory. 


-- DEVICE NOT READY 


The requested device is not completely cycled up (in ae ready 
state). 


Wait for the device to become ready, then retry the command. 


-~ DEVICE NOT IN SYSTEM 
The specified device was not included as a usable device when the 
system was generated. That is, there is no PUD entry for the 


device. The user most likely typed the device mnemonic 
incorrectly. 


~- FILE SYSTEM MESSAGE TASK (F11MSG) MUST BE INSTALLED 


Self-explanatory; install task FIIMSG, then retry the command. 


-- HANDLER TASK NOT RESIDENT 
The handler task for the device being mounted is not resident. 


Load the required device handler task, then retry the command. 
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~- OTHER VOLUME STILL ON LINE 

The user is attempting to mount a volume on a device that 
previously contained a volume that was never dismounted. The 
user most likely removed the volume from the device and replaced 
it with a new volume, without having issued a DMO command for the 
previous volume. 

Replace the current volume with the previous one. Issue the 
appropriate DMO. command, then replace the dismounted volume with 
the next volume to be mounted. Retry the MOU command. 
-~- ILLEGAL FUNCTION FOR NON PRIVILEGED TERMINAL 


Self-explanatory. 


~- HOME BLOCK NOT FOUND 


MOU is unable to obtain the required mount information from the 
volume's home block. One of the following conditions exist: 


1. The volume is not a Files-1l1 volume 

2. The hardware is malfunctioning. For example, the disk 
drive's read/write heads are misaligned. 

-~ I/O SYSTEM ERROR 

An undefinable error occurred during the execution of MOU. 

Retry the command. If the error reoccurs, notify the DEC 

software specialist. 

-- NO SPACE FOR VCB 


There is no space available in the system node pool for the 
volume control block. 


Retry the command. If the failure persists, the system should be 
rebuilt with a larger node pool. 


~~ PARITY ERROR ON DEVICE 


This is a hardware failure; notify field service. 


-- SYNTAX ERROR 


Self-explanatory; refer to the command description for the 
correct syntax. 


~~ UNIT DOES NOT SUPPORT 1600 BPI 
The user specified 1600 BPI for a tape drive that can. only 


support 800 BPI. MOU defaults to 800 BPI and continues 
processing the command. 
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-- VOLUME IS NOT ANSI FORMAT 

Either the hardware is malfunctioning or the volume is not an 
ANSI standard volume. In either case, the volume cannot be 
mounted. 


~- WRONG VOLUME 


The volume's label does not match the label specified in the MOU 
command line. The volume is not mounted. 


Retry the command with the correct volume label specified. 


-~ BYTE ADDRESS 


The user is attempting to open an odd numbered address location. 


-- CAN'T READ MCR COMMAND BUFFER 

OPE failed to obtain the command line with which it was’ invoked. 
This will occur if OPE is invoked using the RUN command, as 
opposed to the prescribed method. 

Retry the command using the prescribed format. If the failure 
reoccurs, notify the DEC software specialist. 


-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


-- INPUT I/O ERROR 


The TTY handler is unable to obtain a command line from the user 
terminal. 


Notify the DEC software specialist. 


-~ INVALID ADDRESS 


The address specified by the user either is not in the range of 
valid memory addresses, or was incorrectly specified. 


-- NUMBER TOO LARGE 


Self-explanatory. 


-~- OUTPUT ERROR 


The TTY handler is unable to issue a message to the user's 
terminal. 


Notify the DEC software specialist. 
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-- PARTITION NOT IN SYSTEM 


Self-explanatory. 


~~ SYNTAX ERROR 
Self-explanatory; refer to the command description for’ the 
correct syntax. 
-- TASK NOT FIXED IN CORE 
Or 
-~ TASK NOT IN SYSTEM 


Self-explanatory. 


-~- ILLEGAL ERROR CODE RECEIVED FROM SPR2.. 

An internal error has occurred. The multiple device despooler 
task has delivered an error code that is not within the range of 
acceptable error codes. 


Notify the DEC software specialist. 


-- ILLEGAL SWITCH COMBINATION 

The user specified a stop switch that conflicts either with a 
begin spooling switch, and/or a resume switch, for the same 
device. 

-- INVALID DEVICE SPECIFICATION 

The user has specified a device that is not a system generated 


device or the device specified is not a carriage controlled unit 
record device; e.g., line printer or teleprinter. 


~~ INVALID OR NONEXISTENT FORM TYPE SPECIFIED 


The user specified a form type that is not in the range of 0 to 
6. 


~~ INVALID SWITCH OR SWITCH VALUE 


Self-explanatory. 
-- NO COMMAND LINE SPECTFIED 


The user typed the OPR command without following it with a 
command specification. 
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-- NO DEVICE SPECIFIED 
Or 
-- NO SWITCH SPECIFIED 


Self-explanatory. 


-- SEND/REQUEST TO SPOOLER TASK FAILED 

The send/reguest directive to either the queue manager task (SPR) 
or the multiple device despooler task (SPR2) has failed. Either 
or both of the tasks are not installed. 
-~ SYNTAX ERROR 

Self-explanatory; refer to the command description for’ the 
correct syntax. 


-—- UNKNOWN ARGUMENT TO /RS: SWITCH 


Self-explanatory. 


-- DIRECTIVE FAILURE 

An undefinable error occurred during the execution of PWD. 

Retry the command. Tf the error reoccurs, notify the DEC 
software specialist. 

-- NONEXISTENT ACCOUNT 


The user is attempting to assign a password to a nonexistent UFD. 


-- NON SYSTEM ACCOUNT MAY ONLY MODIFY OWN PASSWORD 


Self-explanatory. 


-~- READ OR WRITE FAILURE ON DIRECTORY ENTRY 

One of the following conditions exists: 

1. The UFD does not exist 

2. The file is protected against write access 
3. The volume is not mounted 

4. The volume is off line 

5. The device is not write enabled 


6. The hardware has failed 
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PWD -- SYNTAX ERROR 
Self-explanatory; refer to the command description for. the 
correct syntax. 

QUE -- DEVICE dev: DOES NOT CONTAIN A DIRECTORY 
The user has queued a file to be printed, however the device 
designated as the input device does not contain a directory. All 
queue orders up to the device in error have been processed. 
Re-enter the command from the point of error specifying a correct 
input device. 

QUE -- DEVICE dev: IS NOT SPOOLABLE 
The user has queued a file to be printed onto a device that is 
not a spoolable device. Spoolable devices are unit-record 
carriage controlled devices; e.g., line printer or teleprinter. 

QUE -- ERROR OPENING filename -nn 
An error has occured opening the file designated by "filename". 
The reason for the failure is determined by -nn, where -nn is a 
system standard error code. See Appendix N. 
All file specifications up to the file in error have been 
processed. Correct the error and reinput the command from the 
point of failure. 

QUE -- ERROR READING SPRQUEUE.SYS FILE -nn 
An error has occurred while reading the queue file. The reason 
for the error is determined by -nn, where -nn is a system 


Standard error message. See Appendix N. 


Notify the system manager. 


QUE -- GET COMMAND LINE ERROR -1l 


An error occurred while reading the indirect command file. The 
device has cycled down or the file is corrupted. 


Cbtain a listing of the queue file to determine which commands of 
the indirect file have been processed. Correct the errant 


indirect file condition and resume processing from the point of 
failure. 


QUE -- GET COMMAND LINE ERROR ~2 


An open failure has occurred on the specified indirect command 
file. One of the following conditions exists: 
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l. The user directory does not permit read access to the file. 


2. There is a problem with the physical device (e.g., device 
cycled down). 


3. The volume is not mounted. 
4. The specified file directory does not exist. 


5. The file does not exist as specified. 


- GET COMMAND LINE ERROR -3 


The user specified an indirect file in a format that does not 
conform to syntax rules. 


- GET COMMAND LINE ERROR -4 
The maximum depth of three indirect files has been exceeded. 


Locate the point within the indirect files where the fourth level 
of indirection has been specified. Delete this level of 
indirection. All of the commands up to this point have been 
processed. Specify the fourth level of indirection as a separate 
command to QUE. Resume processing of the original indirect 
command files at the command following the fourth level of 
indirection. 


- NO FILES QUEUED 


The user has requested a list of the gueue file, but no files are 
queued. 


This message will also occur if the file [1,4]SPRQUEUE.SYS is 
locked. Tf the file is locked, notify the system manager who 
will take the appropriate action. 


- SEQUENCE NUMBER NOT SUPPLIED FOR MODIFY OR KILL 


The user has entered a modify or kill command omitting’ the 
required sequence number. 


~ SYNTAX ERROR [text string in error] 


Self-explanatory; refer to the command description for the 
correct syntax. 


Tf the command was a modify or kill command, obtain a listing of 
the queued file to determine what part of the command has been 
processed. Re-enter the modify or kill command from the point of 
failure, correcting the syntax error. For all other queue 
commands no processing has occurred. Re-enter the command 
correctly. 
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REA -- DEVICE NOT IN SYSTEM 


The user specified a device mnemonic that has not been’ generated 
into the system. 


REA -- FATAL I/O ERROR 


REA 


REA 


REA 


REA 


RED 


REA, either while reading or writing the task header, encountered 
an error. One of the following conditions exists: 


1. The requested file does not exist in the specified UFD 
2. The UFD does not exist 

3. The file is protected against write access 

4. The volume is not mounted 

5. The volume is off line 


6. The device is not write enabled 


-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 
OR 
-- ILLEGAL LUN NUMBER 


Self-explanatory. 


-- SYNTAX ERROR 

Self-explanatory; refer to the command description for’ the 
correct syntax. 

-- TASK NOT IN SYSTEM 


Self-explanatory. 


-- CAN'T READ MCR COMMAND BUFFER 


REA failed to obtain the command line with which it was’ invoked. 
This will occur if RED is invoked using the RUN command, as 
opposed to the prescribed method of invoking RED. 


Retry the command using the prescribed format. If the failure 
reoccurs, notify the DEC software specialist. 


RED -- CIRCULAR REDIRECT CHAIN 


The user, through a _ sequence of Redirect commands, has 
established a chain of redirection which returns to old-dev. 
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-- DEVICE NOT KNOWN TO SYSTEM 

The user specified a device mnemonic that has not been generated 
into the system. 
-- HANDLER NOT RESIDENT 

This message informs the user that the device handler for. the 
redirected device is not resident. The redirect has been 
successfully complected. 


-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


-- SOURCE DEVICE, OR ITS EXISTING REDIRECT, IS ATTACHED 
Self-explanatory; wait until the device becomes unattached, or 
abort the process that has it attached. 

-- SOURCE DEVICE, OR ITS EXISTING REDIRECT IS ATTACHED 


Self-explanatory; dismount the device and retry the command. 


-- SYNTAX ERROR 

Self-explanatory; refer to the command description for the 
correct syntax. 
-- COMMAND SYNTAX ERROR 

Self-explanatory; refer to the command description for _ the 
correct syntax. 
-- FAILED TO OPEN @ FILE 

The requested indirect command file cannot be found on the volume 
indicated. Either the file does not exist of the file was 
specified incorrectly. 
-- ILLEGAL ERROR/SEVERITY CODE nl n2 n3 

REM failed in its attempt to issue a message to the user 
terminal. nl contains the value in Rl at the time of the 


failure; n2 contains the value in R2; and n3 contains’ the 
return address after calling the error message routine. 
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NOTE 


The high order byte in Rl reflects’ the 
severity code between O and 2. 


The low order byte in Rl reflects’ the 
error message REM was trying to issue. 


Notify the DEC software specialist. 


REM -- ILLEGAL FUNCTION FOR NON-PRIVILEGED USER 


Self-explanatory. 


REM ~- ILLEGAL SWITCH 
The user specified a switch that REM does not recognize. Either 
the switch is not a REM switch, or it was specified in the wrong 
format. 

REM -- INCONSISTENT SWITCH SPECIFIED 


The user specified a switch combination that is confusing to REM. 


REM ~- MAX @ FILE DEPTH EXCEEDED 
The indirect command file, specified by the user, has an indirect 
command file specification as one of its commands. REM can 
process only one indirect file at a time. 
Either recreate the originally specified file replacing the 
offending indirect file specifier with the commands if 
represents, or enter the required commands manually. 

REM -~ TASK taskname FIXED IN MEMORY. 


A task that is fixed in memory cannot be removed. 


Unfix the task, then retry the command. 


REM -~ TASK taskname HAS NONZERO POOL USAGE COUNT 
The user is attempting to remove a task that has initiated an 
activity, and that activity iS on-going; e.g. initiated an 
other task, or an I/O operation. 


Wait for the initiated activity to complete, then retry the 
command. 
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REM -- TASK taskname IS ACTIVE 
or 

REM -- TASK taskname NOT IN SYSTEM 
Or 

REM -- taskname NOT IS SYSTEM 


Self-explanatory 


REM -- library-name HAS NON-ZERO INSTALL COUNT 


The user is attempting to remove a library that has’ installed 
tasks linked to it. 


Remove the installed tasks, then retry the command. 


RUN -- CAN'T READ MCR COMMAND BUFFER 
Run failed to obtain the command line with which it was’ invoked. 
This will occur if RUN is invoked using the RUN command, as 
opposed to the prescribed method. 
Retry the command using the prescribed format. Tf the failure 
reoccurs, notify the DEC software specialist. 


RUN -- HANDLER NOT RESIDENT TO LOAD TASK 


The device handler task, required to load the requested from’ the 
volume on which it resides, is not in the system. 


Load the required handler task, then retry the command. 


RUN -- INSUFFICENT POOL NODES 


There are not enough available pool nodes to run the desired 
task. 


Either wait for a node to become available, or notify the system 
manager. If this has been a persistent problem, the system 
Manager may want to reconfigure the system. 

RUN -~- INVALID KEYWORD 
The user specified a keyword that either is not a valid keyword, 
Or was specified in an illegal format. 

RUN -- INVALID TIME PARAMETER 


The value assigned to the /RSI switch is either invalid, or 
specified in the wrong format. 
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-~- INVALID UIC 
The UFD specified by the user either does not exist, or _ was 
specified in an illegal format. 
-~ INVALID PRIORITY 
The priority specified in the /PRI switch either exceeds’ the 
maximum allowable (250), or was specified in an illegal format. 
-- MEMORY UNAVATLABLE 

Or 
-- PARTITION NOT IN SYSTEM 


Self-explanatory. 


-~- SYNTAX ERROR 
Self-explanatory; refer to the command description for’. the 
correct syntax. 
-- TASK ALREADY ACTIVE 
or 
-- TASK DISABLED 
or 
-~- TASK NOT INSTALLED 


Self-explanatory. 


-- UNRECOGNIZED DIRECTIVE ERROR 

An undefinable error occured during the execution of RUN. 

Retry the command. If the error reoccurs, notify the DEC 
software specialist. 

-- *DIAG* SYSTEM CLOCK CHANGED TO A KW1l [L or P] 

The system was generated as having a KW11L or KW11P clock. SAV 
found that the clock present in the system is opposite from the 
one specified. SAV continues processing and the system is 
started with the clock found as the system clock. 


~- *FATAL* BAD BOOT IN LOW MEMORY 


The first 32-word block of memory has been’ corrupted; most 
likely by hardware. One of the following conditions exists: 
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1. The bootstrap routine was written by a user who failed to 
adhere to the rules. 
2. The hardware failed. 


3. Someone or some running task corrupted real address 0. 


SAV -- *FATAL* FAILED TO READ MCR BUFFER 


SAV 


SAV 


SAV 


SAV 


SAV 


SAV 


SAV failed to obtain the command line with which it was’ invoked. 
This will occur if SAV is invoked using the RUN command, as 
opposed to the prescribed method. 

Retry the command using the prescribed format. If the failure 
persists, notify the DEC software specialist. 


-- *FATAL* ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


-~- *FATAL* dev: IS STILL LOGGED ON 


The user attempted to execute SAV with the specified terminal(s) 
still logged on. 


Either re-enter the command with the /LOG switch specified, or 
log the terminals off, and retry the command. 
-- *FATAL* dev: IS STILL MOUNTED 


The user attempted to execute SAV with the specified device(s) 
still mounted. 


Either re-enter the command with the /MOU switch specified, or 
dismount the devices and retry the command. 

-~- *FATAL* NO SYSTEM CLOCK RESPONSE, RSX-11D CANNOT RUN 

Neither the line frequency clock nor the programable clock will 
respond to SAV. Either there is no clock on the system, or the 


clock does not work. 


Notify your field service engineer. 


-~ *FATAL* RO ROOT OF taskname IS LOADED BEYOND END OF SAVE FILE 


The read-only root of the named multiuser task is either active 
or fixed at an address beyond that which is to be saved. All 
active versions of the task must be deactivated to unload _ the 
read-only root of the task. 


-- *FATAL* RO ROOT OF taskname IS LOADING 
The Executive has initiated the I/O operations to load _ the 


read-only root of a multiuser task. This is a separate operation 
from that used for the impure copies of a multiuser task. 
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SAV -- *FATAL* SHAREABLE GLOBAL sga IS LOADED BEYOND END OF SAVE FILE 
The named SGA is either active or fixed at an address beyond that 
which is to be saved. One of the following steps must be 
performed: 


1. Unload all active or fixed tasks that use the SGA to allow 
the SGA to be unloaded. 


2. Reload the SGA at a lower addresss. 


SAV -- *FATAL* SHAREABLE GLOBAL sganame IS LOADING OR EXITING 


The Executive has initiated the I/O operations to load an SGA or 
write a read/write SGA to disk. The SGA has one of the following 
states: load request pending (GS.LRP), load request queued 
(GS.LRQ), and record request queued (GS.RRQ). 


The system is not quiescent and a SAVE cannot be performed until 
these states have disappeared. 

SAV -- *FATAL* SYNTAX ERROR 
Self-explanatory; refer to the command description for _ the 


correct syntax. 


SAV -- *FATAL* SYSTEM HAS INSUFFICIENT MEMORY 
PARTITION parname WAS OCCUPIED BEYOND AVAILABLE MEMORY 
THE SYSTEM IS NOT RUNNABLE 


This situation is caused by an attempt to truncate a system in 
which some entity (task or SGA) was loaded beyond the available 
memory. 
This error can be caused by bad memory that results in SAVE'S 
assuming that such memory does not exist. If so, call your field 
service engineer. If not, the newly booted system was saved too 
large to run on this configuration. 

SAV ~- *FATAL* TASK taskname HAS I/O IN PROGRESS 
The named task has a nonzero I/O in progress’ count; therefore, 
the system is not quiescent. Wait for the I/O to complete or 
abort the task. 

SAV -- *FATAL* TASK taskname IS LOADED BEYOND END OF SAVE FILE 


The named task is either active or fixed at an address’ beyond 
that which is to be saved. One of the following must be done: 


l. Unfix the task, if it is fixed, 


2. Unload the handler, if the task is a handler, and 
load it at a lower address, 


3. Terminate the active task and perhaps run it at a 
lower address, 


4. Wait for the task to terminate normally. 
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SAV -- *FATAL* TASK taskname IS LOADING OR CHECKPOINTING 


The Executive has initiated the I/O operations to _ load 


or 


checkpoint the named _ task. The task has one of the following 
states: load request pending (TS.LRP), load request queued 


(TS.LRQ), 


The system is not quiescent and a SAVE cannot be performed until 


these states have disappeared. 


SAV -- *FATAL* 11/40 TRAP ECO (KT11—-D) NECESSARY TO RUN RSX-11D 


SAVE detected that a PDP-11/40 hardware modification (ECO) 
necessary for operation of RSX-11D is either not present or is 


failing to operate correctly. 


Notify your field service engineer. 


SAV -- PARTITION parname EXPANDED BY nnnn*32 (DEC) WORD BLOCKS 


SAVE found more memory than was specified at the last save of the 


system or at system generation if no previous save occurred. 
extra amount of memory is nnnn (decimal) 32-word blocks. 
total memory size has been printed in a previous message. 
named partition has been expanded to use the extra memory. 


SAV -- PARTITION parname TRUNCATED BY nnnn*32 (DEC) WORD BLOCKS 


SAVE found less memory than was specified at the last save or 


The 
The 
The 


at 


system generation if no previous save occurred. The difference 
in memory size is indicated by nnnn (decimal) 32-word blocks. 
The total memory size has been printed in a previous message. 
The named partition has been truncated to fix the memory 


available. 


SAV -- THE FOLLOWING EMPTY PATRITION(S) TRUNCATED TO ZERO SIZE: 
parnamel 
parname2 


The system has been successfully reduced in size but all of 
named partitions are completely beyond the available memory. 


the 


Any 


attempt to run a task already installed in one of these 
partitions causes the task to be queued on that partition's 
memory required list (MRL). The task remains on the MRL until it 
is aborted. Any attempt to install a task in such a partition 


results in an INS error message to the effect that the task 
larger than the partition. 


SET -- CAN'T READ MCR COMMAND BUFFER 


is 


SET failed to obtain the command line with which it was’ invoked. 


This will occur if SET is invoked using the RUN command, as 
opposed to the prescribed method. 
Retry the command using the prescribed format. If the failure 


reoccurs, notify the DEC software specialist. 
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-~- CAN'T SET CHARACTERISTICS FOR THIS TYPE TERMINAL 
Self-explanatory; the characteristics specified are 
incompatible. 

-- ILLEGAL CACHE VALUE 


A number that was not in the range 1 through 32,767 (decimal) was 
specified in the /CAC=n switch. 


Retry the command using a number within the specified range. 


-- ILLEGAL FUNCTION FOR MACHINE TYPE 


The /CAC switch was specified while running on a computer other 
than a PDP-11/70. 


ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


or 


PARAMETER ERROR —- BAD DEVICE NAME 


Or 


SPECIFIED DEVICE IS NOT A TERMINAL TYPE DEVICE 


OR 


SPOOLING NOT SUPPORTED IN THIS RELEASE FOR THIS DEVICE 


Self-explanatory. 


~- SYNTAX ERROR 

Self-explanatory; refer to the command description for the 
correct syntax. 
-- DEVICE dev: NOT FOUND IN PUD TABLE 

A file has been queued via a PRINTS macro to a nonexistent system 
device. The gueue entry is automatically dequeued. 
~- ERROR ISSUING SEND REQUEST TO SPR2.. -nn 

An error occurred when SPR issued a Send/Request directive to the 
despooler task (SPR2..). The reason for the error is determined 
by -nn, where -nn is the directive status word (DSW) error code. 
-~ ERROR ON RECEIVE ~—nn 

An error occurred while SPR was receiving a Send/Request 


directive. The reason for the error is determined by -nn, where 
-nn is the directive status word (DSW) error code. 
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SPR -- ERROR READING SPRQUEUE.SYS FILE -nn 


or 

ERROR WRITING SPRQUEUE.SYS FILE -nn 
Or 

ERROR OPENING SPRQUEUE.SYS FILE -nn 
Or 


ERROR CLOSING SPRQUEUE.SYS FILE -nn 


An error occurred when SPR attempted to access the queue file. 
The reason for the error is determined by -nn, where -nn is the 
directive status word (DSW) error code. 


NOTE 


If the error is persistent, the queue file is corrupted. 
Perform the queue error procedure documented in the 
RSX-11D System Managers Guide. 


SPR -- INVALID SEQUENCE NUMBER 


The sequence number for a kill or modify command does not 
correspond to any sequence number in the queue. 


Retry the command with the correct seguence number specified. 


SPR -- SPRQUEUE.SYS FILE CAPACITY EXCEEDED 


The SPRQUEUE.SYS file has a capacity of 2047 queue orders. This 
capacity has been exceeded, and the last order has not been 
queued. 


Avoid adding more orders to be despooled. Allow the despooler 
task to process sufficient orders to create space in the queue. 
Then, retry the command. 


SPR2.. -- DEVICE dev:, FAILED TO OPEN FILE 


The despooler was unable to open an output file on device (dev:). 
The open order is automatically aborted by the despooler. Either 
the file to be opened was deleted after a reguest to print it was 
queued, or the volume on which the file resides was dismounted. 


SPR2.. -- DEVICE dev: TIMED OUT 


Three minutes have elapsed since a QIO output order was issued to 
device (dev:). The multiple device despooler has received no 
notification from the handler that the order has completed. This 
error normally occurs when the line printer is not in a ready 
state, and will be accompanied by a not ready message issued by 
the device handler. This message requires no user action. 


SPR2.. -~ GET$ ERROR - DEVICE dev: ERROR CODE -nn 


An input error occurred on the device that contains the file 
being transfered to device dev:. The reason for the error is 
determined by -nn, where -nn is a system standard error. code. 
See Appendix N. This message does not require user action. 


A-48 


MCR COMMAND SUMMARY AND ERROR MESSAGES 


SPR2.. -- GETS ERROR - DEVICE dev: - ERROR CODE 40 


The despooler encountered an input record size, on device dev:, 
that is greater than 256 bytes. Printing of the input file is 
automatically aborted. 


See Appendix N. 


SPR2.. -- INTERNAL ERROR - BAD SEND/REQUEST FROM ...OPR 


OPR, as a result of an OPR command issued by the user, issued a 
send/request directive to the despooler. The request code does 
not match the appropriate send/request assigned codes. 


Document the occurrence along with the OPR command issued, and 
notify the DEC software specialist. 


SPR2.. -- INTERNAL ERROR -- DUPLICATE DEVICES ON DEVICE dev: 


The queue manager task directed the despooler task to transfer 
data to a device (dev:) that is currently being used. Perform 
the corrective action detailed in the RSX-11D System Managers 
Guide. 


SPR2.. -- INTERNAL ERROR -- FAILED TO ASSIGN LUN 
The despooler task was unable to assign the LUN for a given 
device. This message will be issued as a result of a system 
generation in which the required device was deleted. 
Perform the corrective action detailed in the RSX-11D System 
Manager's Guide. 

SPR2.. -- INTERNAL ERROR -- TOO MANY SIMULTANEOUS DEVICES 
The despooler task notified the queue manager task that it is 
capable of processing n devices’ simultaneously. The queue 
Manager task, however, delivered n+l process orders. 
Perform the corrective action detailed in the RSX-11D System 
Manager's Guide. _ 

SPR2.. -- INTERNAL ERROR ~ ZERO COPIES SPECIFIED 
The gueue manager task requested a despooler operation on a file, 
but it also requested that no copies are to be printed. The 
queue file may be corrupt. 
Perform the corrective action detailed in the RSX-11D System 
Manager's Guide. 

SPR2.. -- I/O ERROR ON DEVICE dev: ~ ERROR CODE ~-=-nn 
An I/O error occurred during an output operation on device 
(dev:). The reason for the error is determined by -nn, where -nn 


is a system standard error code. See Appendix N. This message 
does not require user action. 
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SPR2.. -- QIOWS FAILURE ON DEVICE dev: DSW=-nn - DEVICE IN WAIT 
A QIO directive error occurred on device dev:. The reason for 
the error is determined by -nn, where -nn is the directive status 
word (DSW) error code. 


Correct the error condition, then issue the appropriate OPR 
command: 


OPR dev:/RS to continue 


OPR dev:/AB to abort the operation 


SPR2.. - SEND/REQUEST TO SPR... FAILED 


Task SPR... is not installed; install the task. 


SYS -- ILLEGAL SWITCH 
The user specified a switch that SYS does not recognize. Either 
the switch is not a SYS switch, or it was specified in the wrong 
format. 

SYS -- SYNTAX ERROR 


The user entered a SYS command in a format that does not conform 
to syntax rules. 

TIM -- CAN'T READ MCR COMMAND BUFFER 
TIM failed to obtain the command line with which it was’ invoked. 
This will occur if TIM is invoked using the RUN command, as 
opposed to the prescribed method. 
Retry the command using the prescribed format. Tf the failure 
reoccurs, notify the DEC software specialist. 


TIM -- ILLEGAL FUNCTION FOR NON-PRIVILEGED USER 


A non-privileged user is not allowed to modify the time or date. 


TIM -- SYNTAX ERROR 
Self-explanatory; refer to the command description of the 
correct syntax. 

UFD -~ DEVICE NOT IN SYSTEM 


The user specified a device mnemonic that has not been generated 
into the system. 


A-50 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UNL 


MCR COMMAND SUMMARY AND ERROR MESSAGES 


-- DIRECTORY ALREADY EXISTS 


Self-explanatory. 


-- FAILED TO CREATE DIRECTORY 


The device is write locked; write enable it and retry the 
command. 


~- FAILED TO ENTER IN MFD 


The UFD command task is unable to establish a pointer in _ the 
master file directory to the newly created UFD. 


Either the hardware has failed, or the master file directory is 
corrupted. 
-- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 
or 
-- NOT FILES-11 DEVICE 


Self-explanatory. 


-- PRIVILEGE VIOLATION ON MFD 


The UFD command task, by virtue of the UIC under which it is 
running, is not allowed access to the volume MFD. 


-- SYNTAX ERROR 


Self-explanatory; refer to the command description of the 
correct syntax. 


-- VOLUME NOT MOUNTED 


Self-explanatory. 


~- WRITE ATTRIBUTES FAILED 


The hardware has malfunctioned; notify field service. 


--~ CAN'T READ MCR COMMAND BUFFER 

UNL failed to obtain the command line with which it was’ invoked. 
This will occur if UNL is’ invoked using the Run command, as 
opposed to the prescribed method. 


Retry the command using the prescribed format. If the failure 
reoccurs, notify the DEC software specialist. 
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UNL -- HANDLER NOT RESIDENT 
Or 
UNL -- ILLEGAL FUNCTION FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


UNL -~ NODE FOR EXIT UNAVATLABLE 


A required pool node is unavailable; the system is saturated 
with active tasks. 


Either wait for a node to become available or notify the system 
Manager. The system manager may want to reconfigure the system. 


UNL -~ SYNTAX ERROR 


Self-explanatory; refer to the command description for’ the 
correct syntax. 


UNL -- TASK NOT IN SYSTEM 


Self-explanatory. 


A.2.1 Messages from Task MCRERR 


Nine of the RSX-11D MCR functions are performed by a single 
multifunction task named MFT: 


ABO (Abort task) 

ALT (Alter priority) 

CAN (Cancel request) 

FIX (Fix task in memory) 
UNF (Unfix task) 

DIS (Disable task) 

ENA (Enable task) 

LOA (Load handler task) 

RES (Resume task execution) 


MCRERR is the error handling task for MFT. The advantage of MCRERR is 
that it needs to be resident only when error handling is required. 
The messages issued by MCRERR are described below. 


Each message consists of two lines. The first line printed is’ the 
command that caused the error. The second line is the actual error 
message. 


Message descriptions are followed in the manual by a message number. 
If MCRERR is not installed, this number is printed in the following 
format on the terminal instead of the message. 


XXX ~~ ERRnn 
xxx = the function called, e.g., LOA. 
nn = the message number. 
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CAN'T READ MCR COMMAND BUFFER 
The requested function failed to obtain the command line 
with which it was invoked. This occurs when the function is 
requested using the RUN command as opposed to the prescribed 
method. 
Retry the command using the prescribed format. If the 
failure reoccurs, notify the DEC software specialist. 

DEVICE NOT IN SYSTEM 
The specified device was not defined during system 


generation. The user most likely typed the device mnemonic 
incorrectly. 


HANDLER NOT RESIDENT 


The user specified a device for which the reguired handler 
is not resident. 


Load the required device handler task and retry the command. 


ILLEGAL FUNCTION OR SWITCH FOR NON-PRIVILEGED TERMINAL 


Self-explanatory. 


ILLEGAL SWITCH OR SWITCH COMBINATION FOR THIS FUNCTION. 


Self-explanatory; refer to the description of the command. 


INSUFFICIENT POOL NODES TO PERFORM RQST 


Required pool nodes are unavailable; the system is 
Saturated with active tasks. 


Either wait for nodes to become available, or not 
system manager. The system manager may want to rec 


the system. 


INVALID KEYWORD SPECIFIED 


Self-explanatory. 


INVALID PRIORITY 


Self-explanatory. 


INVALID TIME PARAMETER SPECIFIED 


Self-explanatory. 
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INVALID UIC SPECIFIED 


Self-explanatory. 


MEMORY UNAVAILABLE 


NODE 


Self explanatory; remove unnecessary tasks, or wait 
memory to become available and then retry the command. 
FOR FIXING UNAVAILABLE 


A required pool node is’ unavailable; the system 
saturated with active tasks. 


Either wait for a node to become available, or notify 


for 


is 


the 


system manager. The system manager may want to reconfigure 


the system. 


NOT ALLOWED IN TIME-~SCHEDULED PARTITION 


Self-explanatory. 


NUMERIC CONVERSION ERROR 


Self-explantory. 


PARTITION TOO SMALL FOR TASK 


Self-explanatory; install the task in a larger partition or 


reduce the size of the task. 


PLEASE LOGON WITH "[UIC]" 


The user has not logged onto the system uSing the 
command. 


Log on and retry the command. 


SPECIFIED PARTITION DOES NOT EXIST 


HELLO 


Self-explanatory; if the error was not caused by mistyping 


the partition name, notify the system manager. 


SYNTAX ERROR 


TASK 


Self-explanatory. 


ALREADY FIXED 


Self-explanatory. 
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ALREADY (OR STILL) ACTIVE 


Self-explanatory 


CAN'T BE DISABLED 


The task is not enabled. 


CHECKPOINTABLE 


The task is checkpointable and, therefore, cannot be fixed 
in memory. 


DISABLED 


The specified task must be enabled before it can be fixed. 


EXITING 


The requested function cannot be performed because the 
specified task is in the process of exiting from the system. 


LOADING OR EXITING 


The requested function cannot be performed because the 
specified task is either being loaded or is exiting. 


NOT ABORTABLE 


An attempt was made to abort a task that was task built as 
not abortable using the /-AB switch. This task cannot be 
aborted. 


NOT ACTIVE 


The requested function cannot be performed because _ the 
specified task is not active. 


NOT DISABLED 


Self-explanatory. 


NOT ENABLED 


Self-explanatory. 
NOT FIXABLE 


The specified task was not declared fixable at task build 
time. The task must be built with the /FX switch specified. 
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TASK NOT FIXED 


Self-explanatory. 


TASK NOT IN SYSTEM 


Self-explanatory. 


TASK NOT SUSPENDED 


Self-explanatory. 


UNKNOWN DIRECTIVE ERROR 


An unidentifiable error occurred 


requested MFT function. 


Retry the command. If the error 


software specialist. 
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B.1 PIP COMMAND SUMMARY 
APPEND 


outfile=infile-l 
{[,infile-2,...,infile-n] /AP[/FO] 


where /FO is File Owner 
COPY 


outfile[/switch] =infile-l 
[,infile-2,...,infile-n] 


Opens an existing file 
(outfile) and merges 
the input file(s) 

onto the end of it. 


Creates a copy of a 
file on the same or 


[/switch] another device. 
/switch=EBL:n[.] Block allocated. 
co Contiguous output 
-CO Non-contiguous output 
FO File Owner 
NV New version See Table 2-3 for a 
SU Supersede complete description 
of these switches 
DEFAULT 


dev: [ufd] /DF 


DELETE 


infile-1l[,infile-2,...,infile-n] 
/DE 


ENTER 
outfile=infile-1l 


[,infile-2,...,infile-n] /EN[/NV] 
where /NV is New Version 


FREE 


dev:/FR 


Changes PIP's default 
device and/or ufd. 


Deletes files, 


Enters a pseudonym for 

a file in a directory 

with an option to 

force the version 

number of “outfile" to be one 
greater than the latest 
version for the file. 


Prints out the available 
space on a volume. 
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IDENTIFY 
/ID 
LIST 
(1) listfile=infile-l[,...,infile-n]/LI 
Or 
(2) infile-l[,...,infile-n]/LI 
where TI: is listfile in format 2 
Alternate Mode Switches 
/BR Brief Format 
/FU[n] Full Format 
/TB Total Blocks Format 
PROTECT 
Infile-1[/PR[/SY[:RWED] [/OW[:RWED] ] 


[/GR[:RWED] ] [/WO[:RWED]]/FO 


Causes the version of 
PIP currently in use to be 
displayed on the terminal. 


Lists one or more directories 
with an option to specify 
directory listing formats. 


For a complete description of 
these switches, see 


the RSX-11D Utility 
Programs Procedures Manual. 


where SY is system access rights. 
OW is member access rights. 
GR is group access rights. 
WO is world access rights. 
RWED is read, write, extend, 


delete privilege. 


FO is File Owner subswitch 


PURGE 


infile-1l[{,infile-2,...,infile-n] /PU[: 


REMOVE 


infile-1[,infile-2,...,infile-n]/RM 


RENAME 
outfile=infile-1l 
[,infile-2,...,infile-n]/RE 
[/NV] 


where NV is New Version. 


SPOOL 
infile-1[{,infile-2,...,infile-n] 
/SP 
UNLOCK 


infile-1[,infile-2,...,infile-n] 
/UN 


n] 
Deletes a specified range of 
obsolete versions of a file. 


Removes) an entry from a 
directory file. 


Changes the name of a 

file with an option to 

force the version 

number of “outfile" to be one 
greater than the latest 
version for the file. 


Specifies a list of 
files to be printed and _ then 
deleted. 


Unlocks a file which 
was locked as a result of 
being improperly closed. 
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UPDATE 


outfile=infile-1 Cpens an existing 
[,infile-2,...,infile-n]/UP[/FO] file(s) (infile) 

it, from the 

beginning, onto outfile. 


and writes 
where FO is File Owner 
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B.2 PIP ERROR MESSAGES 


Errors encountered by PIP, during processing, are reported to the user 
in the following format: 


PIP ~-<main error message> 
<filename or filespec>-<secondary error message> 


The filename or filespec, if present, identifies the file or set of 
files being processed when the error occurred. If the error was 
detected or caused by the operating system, file system, or device 
handler, the secondary error message is included to explain the cause 
of the error. 


PIP error messages are contained in message files on the_- system 
device. If PIP cannot access the message files, because the system 


device (SY:) is not mounted or MO is not loaded, errors are _ reported 
in the following format: 


PIP ~-ERROR CODE nn. 
<filename or filespec>~<HANDLER CODE -mm.> 


or 


<QIO ERROR CODE -qqg.> 


where 
nn is one of the PIP error codes contained in 
Table 2-5. 
—mm is one of the system standard, file 


primitive, or file control service codes 
listed in Appendix I of the IAS/RSX-11 I/O 


Operations Reference Manual. 


—qq is one of the directive error codes listed 


in Appendix I of the IAS/RSX-11 I/O Opera- 
tions Reference Manual. 


The PIP error messages, their description and suggested user actions 
are as follows. 


PIP -- ALLOCATION FAILURE -— NO CONTIGUOUS SPACE 


Contiguous space available on the output volume is’ insufficient 
for the file being copied. 


Delete contiguous files that are no longer required on the output 
volume, and retry the command. 


PIP -- ALLOCATION FAILURE ON OUTPUT FILE 
or 
PIP ~- ALLOCATION FAILURE - NO SPACE AVAILABLE 


Space available on the output volume is insufficient for the file 
being copied. 


Delete files that are no longer required on the output volume, 
and reenter the command. 


PIP 


PIP 


PIP 


PIP 


PIP 


PIP 


PIP 


PIP 


PIP 
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-- BAD USE OF WILD CARDS IN DESTINATION FILE NAME 


The user has specified a wild card "*" for an output file name 
where use of a wild card is explicitly disallowed. 


Reenter the command with the proper output file explicitly 
specified. 


-- CANNOT FIND DIRECTORY FILE 


The user has specified a ufd that does not exist on the’ specific 
volume. 


Reenter the command specifying the correct ufd. 
-- CANNOT FIND FILE(S) 


The file(s) specified in the command were not found in _ the 
designated UFD and device. 


Check the filespec and retry. 
-~ CANNOT SPOOL BY FILE ID 

The /FI switch cannot be used with the spool command. 

Retry command with appropriate filename. 
~~ CANNOT RENAME FROM ONE DEVICE TO ANOTHER 

The user has attempted to rename a file across devices. 

Reenter the command renaming the file on the input volume; then, 
enter another command to transfer’ the file to the originally 
intended volume. 
-- CLOSE FAILURE ON INPUT FILE 

Or 


-~- CLOSE FAILURE ON OUTPUT FILE 


For some reason, the input or output file cannot be _ properly 
closed. The file will be locked to indicate possible corruption. 


Retry the command. If the error reoccurs, run the verify utility 
VFY, against the volume in question to determine if it is 
corrupted. VFY is described in Chapter 9. 

~- COMMAND SYNTAX ERROR 


The user has entered a command in a format that does not conform 
to syntax rules. 


Reenter the command with the correct syntax. 
-- DEVICE NOT MOUNTED 
The message is self-explanatory. 


Mount the device, and retry the command. 
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-~- DIRECTORY WRITE PROTECTED 


PIP could not remove an entry from a directory because the unit 
was write protected, or because of privilege violations. 


Write enable the unit, or have the owner of the directory change 
its protection. 


-~- ERROR FROM PARSE 

The specified directory file does not exist. 
Reenter the command with the correct ufd specified. 
~~ FAILED TO ATTACH OUTPUT DEVICE 


An attempt to attach a record-oriented output device has failed. 
This is usually caused by the device handler not being resident. 


Load the device handler and reenter the command. 
~- FAILED TC DELETE FILE 
or 
~~ FAILED TO MARK FILE FOR DELETE 
The user has attempted to delete a protected file. 
Reguest PIP under the correct UIC and reenter the command. 
-~ FAILED TO DETACH OUTPUT DEVICE 


Occurs if device handler is not loaded or if some system failure 
occurs. 


Verify that the device handler is loaded and retry. TE problem 
persists, contact software support. 


-~- FAILED TO ENTER NEW FILE NAME 


The user has specified a file that already exists in the 
directory file, or the user does not have the necessary 
privileges to make entries in the specified directory file. 


Reenter the command insuring that the file name and ufd are 
specified correctly or reguest PIP under the correct UIC and 
reenter the command. 

~~ FAILED TO FIND FILE(S) 


The file(s) specified in the command were not found in _ the 
designated UFD and device. 


Check the filespec and retry. 
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~~ FAILED TO GET TIME PARAMETERS 


An internal system failure occurred while PIP was trying to 
obtain the current date and time. 


Retry command. Tf the problem persists, consult software 
supporet. 


-~- FAILED TO OPEN STORAGE BITMAP FILE 


PIP could not read the specified volume's' storage bit map, 
usually because of a privilege violation. 


Retry by running PIP under a system UIC, or have the system 
manager change the protection on the storage bit map. 


-~ FAILED TO READ ATTRIBUTES 


The user's volume is corrupted or the user does not have the 
necessary privileges to access this file. 


Ensure that PIP is running under the correct UIC. If the UIC is 
correct, then run the verify utility, VFY, against the volume in 
question to determine where and to what extent the volume is 
corrupted. 

-- FAILED TO REMOVE DIRECTORY ENTRY 


PIP could not remove an entry from a directory because the unit 
was write protected, or because of privilege violations. 


Write enable the unit, or have the owner of the directory change 
its protection. 


~~ FILE IS LOST 


PIP has removed a file from its directory, failed to delete it, 
and failed to restore the directory entry. 


Run the lost file scan in VFY to recover the file name. 
-- FAILED TO SPOOL FILE FOR PRINTING 


Insufficient system dynamic memory is available, or there are too 
many files in the spooler queue. 


Wait and reenter command again. 
-~ FAILED TO WRITE ATTRIBUTES 


The user volume is corrupted or the user does not have’ the 
necessary privileges to write the file. 


Ensure that PIP is running under the correct UIC. If the UIC is 
correct, then run the verify utility, VFY, against the volume in 
question to determine where and to what extent the volume is 
corrupted. VFY is described in Chapter 9. 
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-~- FILE NOT LOCKED 

The user issued an unlock command for a file that was not locked. 
Reenter the command specifying the correct file. 

-~- ILLEGAL CCMMAND 

The user has entered a command that is not recognized by PIP. 
Reenter the command with the PIP command correctly specified. 
-~ ILLEGAL SWITCH 

The user has specified a switch that is not a legal PIP switch. 
Reenter the command with the correct switch specified. 

~- ILLEGAL "*" COPY TO SAME DEVICE AND DIRECTORY 

The user has attempted to copy all versions of a file into’ the 
same directory that is being scanned for input files. This would 


result in an infinite number of copies of the same file. 


Reenter the command renaming the files, or copying them into a 
different directory. 


-~ ILLEGAL USE OF WILD CARD VERSION 


The use of a wild card version number in the attempted operation 
would result in inconsistent or unpredictable output. 


Retry the command with different options or with explicit or 
default version number. 


-- I/O ERROR ON INPUT FILE 
or 
~- I/O ERROR ON OUTPUT FILE 
One of the following conditions exists: 
The device is not on line, 
The device is not mounted, 


The hardware has failed. 
The volume is full 


Mm WD Ee 


- Determine which condition exists. 
Rectify the condition. 
Reenter the command. 


WN FR 


~~ EXPLICIT OUTPUT FILE NAME REQUIRED 


This message is self explanatory. 


Reenter the command with the output file name explicitly 
specified. 
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-- NOT A DIRECTORY DEVICE 


The user has issued a directory-oriented command to a device 
(such as a printer) that does not have directories. 


Reenter the command without specifying a ufd 
~~ NOT ENOUGH BUFFER SPACE AVAILABLE 


PIP has insufficient I/O buffer space to perform the requested 
command. 


Have the system manager rebuild PIP with more buffer space. 
~~ NO SUCH FILE(S) 


The file(s) specified in the command were not found in _ the 
designated UFD and device. 


Check the filespec and retry. 
~- ONLY [*,*] IS LEGAL AS DESTINATION UIC 


The user has specified a ufd other than [*,*] as the output file 
UIC for a copy. 


Reenter the command line with [*,*] specified as the output ufd. 
~- OPEN FAILURE ON INPUT FILE 

Or 
~- OPEN FAILURE ON OUTPUT FILE 
An I/O or file system error has occurred (i.e., a privilege 
violation, an attempted write to a locked unit, parity error, 


etc.). 


Determine the cause of the problem, rectify or circumvent’ the 
problem, and retry command. 


-~- OUTPUT FILE ALREADY EXISTS-NOT SUPERSEDED 


An output file of the same name, type, and version as the file 
already exists. 


Retry the copy with the /NV switch to assign a new version number 
or the /SU switch to supersede the output file. 


-~- TOO MANY COMMAND SWITCHES ~- AMBIGUOUS 


The user has specified too many switches, or the switches 
conflict. 


Reenter the command specifying the correct set of switches. 
~- VERSION MUST BE EXPLICIT OR "*" 


The version number of the specified file must be expressed 
explicitly, or as a wild card "*", 


Reenter the command with the version number correctly expressed. 
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B.2.1 PIP Error Codes 


Table B-l identifies the error codes PIP issues when it doesn't have 
access to the message files. Message descriptions and suggested user 
actions are identical to the information contained in Section B.2. 


Table B-l1 
PIP Error Codes 


Error 
Code PIP Error Message is: 


COMMAND SYNTAX ERROR 

ILLEGAL SWITCH - 

TOO MANY COMMAND SWITCHES - AMBIGUOUS 

ONLY [*,*] IS LEGAL AS DESTINATION UIC 
ILLEGAL COMMAND 

ILLEGAL "*" COPY TO SAME DEVICE AND DIRECTORY 
BAD USE OF WILD CARDS IN DESTINATION FILE NAME 
EXPLICIT OUTPUT FILE NAME REQUIRED 

ALLOCATION FAILURE - NO CONTIGUOUS SPACE 
ALLOCATION FAILURE ~ NO SPACE AVAILABLE 
ALLOCATION FAILURE ON OUTPUT FILE 

I/O ERROR ON INPUT FILE 

I/O ERROR ON OUTPUT FILE 

ILLEGAL USE OF WILD CARD VERSION 

OPEN FAILURE ON INPUT FILE 

OPEN FAILURE ON OUTPUT FILE 

CLOSE FAILURE ON INPUT FILE 

CLOSE FAILURE ON OUTPUT FILE 

FAILED TO DETACH OUTPUT DEVICE 

DEVICE NOT MOUNTED 


OUTPUT FILE ALREADY EXISTS - NOT SUPERSEDED 


FAILED TO MARK FILE FOR DELETE 
FILE IS LOST 

VERSION MUST BE EXPLICIT OR "*" 
ERROR FROM PARSE 

FAILED TO DELETE FILE 

CANNOT FIND DIRECTORY FILE 

FAILED TO ATTACH OUTPUT DEVICE 
FAILED TO GET TIME PARAMETERS 

NOT A DIRECTORY DEVICE 

FAILED TO WRITE ATTRIBUTES 

FAILED TO READ ATTRIBUTES 

FILE NOT LOCKED 

FAILED TO ENTER NEW FILE NAME 
FAILED TO RESTORE ORIGINAL DIRECTORY ENTRY ~ FILE IS LOST 
CANNOT RENAME FROM ONE DEVICE TO ANOTHER 
FAILED TO SPOOL FILE FOR PRINTING 
CANNOT SPOOL BY FILE ID 

FAILED TO OPEN STORAGE BITMAP FILE 
FAILED TO FIND FILE(S) 

CANNOT FIND FILE(S) 

NO SUCH FILE(S) 

FAILED TO REMOVE DIRECTORY ENTRY 
DIRECTORY WRITE PROTECTED 

NOT ENOUGH BUFFER SPACE AVAILABLE 


C.1 FLX COMMAND SUMMARY 


APPENDIX C 


FLX COMMAND SUMMARY AND ERROR MESSAGES 


The FLX utility has only one command. 


outfile=infile-l[,infile-2,...,infile-n] 


/switch 


where switch 


BS:n 


co 


DE 


DI 


DO 


FAsn 


FB:n 


FC 


Performs file conver- 
sion between DOS-1l, 
RT-11 and Files-1l 
formats. 


Indicates the number 
of contiguous blocks 
to be allocated to 
the output file. 


Specifies the block 
size for cassette 
tape output. 


Indicates’ that the 
output file is to be 
contiguous. 


Deletes files from a 
DOS-1l1, RT-11, 
DECtape or disk. 


Causes a directory 
listing of DOS 
volumes; or DOS or 
RSX cassette tape 
volumes to be listed 
on TIs. 


Tdentifies the file 
as a DOS-11 formatted 
file 

Formatted ASCII. 


Formatted binary. 


Indicates that 
FORTRAN carriage 
control conventions 


are to be used. 
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ID 


IM:n 


LI 


NU:n 


RS 


RT 


SP 


UI 


VE 


ZE 


Requests the current 
version number of 
FLX. 


Image mode. 
Same as DI. 


Used with /ZE and /RT 
Switches to specify 
the number of 
directory blocks’ to 
allocate. 


Indicates the file is 
a Files-1l formatted 
file. 


Indicates the 
specification as an 
RT-11 format. 


Indicates that the 
converted file is to 
be spooled to L.P. 


Indicates that the 
output file is to 
have the same UIC as 
the input file. 


Verify after write 
(for cassette only). 


Initiates DKn:, DTn:, 
or MTn: for DOCS-11 
format or CTn: for 
DOCS or RSX format. 
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C.2 FLX ERROR MESSAGES 


Errors encountered by FLX, during processing, are reported on _ the 
user's terminal. 


The FLX error messages, their descriptions and suggested user actions 
are as follows. 


FLX ~- BAD LIST FILE SPEC 
The user has specified one of the following: 
1. More than one output file for an /LI or /DI operation. 
2. Wild cards in the output file for an /LI or /DI operation. 
Reenter the command correctly. 

FLX -- CAN'T OPEN FILE 
The specified file cannot be found in the requested directory. 
Check file name, and retry. 

FLX -~ CO FILES TO MT: NOT ALLOWED 


The user has appended the /CO switch to a magnetic tape output 
file specifier. 


Retry without the /CO switch specified. 


FLX -~- CASSETTE ERROR I/O TERMINATED 
An unexpected hardware error has occurred during the 
end-of-volume sequence on a cassette volume. The transfer is 
aborted. 


Retry the previously executed command. 
FLX ~~ COMMAND SYNTAX ERROR 


The user has entered a command in a format that does not conform 
with syntax rules. 


Reenter the command with the correct syntax. 
FLX ~~ CONFLICTING TRANSFER MODES SPECTFIED 
The user has specified conflicting transfer mode swithces. 
Example: 
SY:=DT: FOO.OBJ/IM/FB 
Retry with switches correctly specified. 
FLX ~- DOS or RT-11 DEVICE NOT VALID FORMAT 
The device specified with the /DO switch has an incorrect DOS 
file structure; or the device specified with the /RT switch has 


an incorrect RT file structure. 


Correct the device problem, and retry. 
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FLX -- DT: UFD FULL 


The DECtape directory is full - there is no room for the file 
under the specified ufd. 


1. Clean up the directory by deleting unnecessary files. 
2. Retry under a different ufd. 
FLX -- END OF VOLUME ON CASSETTE 
MOUNT NEW CASSETTE? (Y or CR) 
Physical end-of-tape has been encountered during a cassette 
transfer. The tape rewinds, and the user is asked to mount the 


next cassette. 


The user has two choices of action. These choices are as 
follows: 


1. The user can mount the new cassette and type Y to. signify 
that the cassette is mounted, and that FLX can continue 
transferring data. 

2. The user can enter a carriage return. This informs FLX that 
there is no next cassette. EOF is assumed and the transfer 
is terminated. 

FLX -- ERROR DURING DIRECTORY I/O 

One of the following conditions exists: 

l. The device is not write enabled. 

2. /DO, /RT, or /RS switches were incorrectly specified. 


3. The volume is not of the proper format. 


4. A hardware error occurred during a directory I/O operation 
(i.e., bad tape). 


1. Turn on the write enable switch. 
2. Respecify the /DO, /RT, or /RS switches correctly. 
3. Mount a volume which is in the proper format. 
4. Retry. 
FLX -~- FILE ALREADY EXISTS 


The user specified an output file that already exists on _ the 
(DOS) device specified. 


Reenter the file specifier using a new or corrected filename. 
FLX ~~ FILE NESTING EXCEEDED 
More than one level of indirect files was specified. 


Retry with only one level of indirect file specified. 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 
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-- FILE NOT FOUND 


The named file does not appear in the requested directory, as 
specified. 


Retry with the file name and directory correctly specified. 
~~ FILE OUT OF SEQUENCE 
A cassette multivolume file is being accessed out of sequence. 


This is a warning message. The transfer will continue unless 
stopped by the user. 


-- @FILE SYNTAX ERROR 


A syntax error was encountered during indirect command file 
processing. 


1. Edit the indirect command file using either EDI or SLP. 
2. Rerun FLX using the corrected command file. 
-~- FMTD ASCII RECORD FORMAT BAD 
Or 
~~ FMTD BINARY RECORD FORMAT BAD 


Either the file is corrupted, or the file is not of the specified 
type. 


If the file is corrupted, there is no recovery possible. If the 
file type is incorrect, retry with the correct type. 


~~ INCORRECT # IN/OUT SPECS 
The user specified more than one output specification. 


Retry the command with the proper syntax; i.e., only one output 
specification. 


-~- INVALID DEVICE 


The user specified a device that cannot be utilized as an input 
Or output device; i.e., trying to read from a line printer. 


Retry with a legal device specified. 
~- INVALID DOS OR RT-11 FILE SPEC 
Or 
-- INVALID RSX FILE SPEC 


The file specifier does not conform to proper’ syntax; or the 
specified device is not supported for the desired operation. 


Reenter the file specifier with the proper syntax. 
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FLX ~- INVALID SWITCH 


The user has specified a switch that is not a FLX switch, or does 
not conform to proper syntax. 


Reenter the command specifying the correct switch. 
FLX ~~ I/O ERROR 
One of the following conditions exists. 
1. The specified device is not on-line. 
2. The specified volume is not mounted. 
3. A hardware error has occurred (i.e., bad tape). 
l. Ensure that the device is on-line, and the volume is mounted 
and in good condition. 
2. Reenter the command. 
FLX -- I/C ERROR DELETING LINKED FILE 


An uncorrectable error occurred while a DOS DK or DT file was 
being deleted. 


No action required - the file is effectively deleted. 
FLX -- I/O ERROR INITIALIZING DIRECTORY 


/DO, /RT, or /RS switch not specified for a DOS, RT, or RSX 
volume initialization command; or 


One of the following conditions exists: 
1. The specified device is not on-line. 
2. The specified volume is not mounted. 
3. A hardware error has occurred (i.e., bad tape). 
1. Ensure that the device is on-line, and the volume is mounted 
and in good condition. 
2. Reenter the command with the required switch specified. 
FLX -- I/O ERROR ON COMMAND INPUT 


An unexpected error in command input was encountered from either 
an indirect command file or TI:; FLX exits. 


Restart FLX. 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 


FLX 
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~- I/O ERROR ON LIST FILE 

An error occurred on the output device during a /DI or /LI 
sequence. A hardware problem exists in the output device (e.g., 
device powered down). 

1. Rectify the condition. 

2. Retry the command. 


~- OUTPUT DEVICE FULL 


The DOS or RT-11 output volume does not contain enough space _ for 
the output file. 


Delete any unnecessary files, and rerun the job. 
~~ OUTPUT FILE SPEC NOT ALLOWED 


The user specified an output file specifier for a command that 
does not allow an output file specifier. 


Reenter the command without an output file specifier. 

~~ RECORD TOO LARGE 

FLX has detected an input record that is larger than the 
specified or implied record size for the file - the file is 
corrupted. 

The file in guestion cannot be used with FLX. 


-- SPECIFIED RECORD SIZE BAD, 512. USED 


The record size specified by the /FA or /FB switch is not 
acceptable. A record size of 512 (decimal) bytes is assumed. 


This is a warning message ~- no action is required. 
~- UNABLE TO ALLOCATE FILE 


The output volume for the specified file has no available 
space - the volume is full. 


Delete any unnecessary files, and rerun the job. 

~~ UNABLE TO OPEN FILE 

The requested file cannot be located in the specified directory. 
Reenter the command with the correct file specified. 

-~- UNABLE TO OPEN LIST FILE 


The list file cannot be opened under the specified file name _ and 
ufd; specified device may not be a valid RSX volume. 


Reenter the command specifying the correct file name, device and 
ufd. 


FLX 


FLX 


FLX 


FLX 
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~- UNDIAGNOSABLE REQUEST 

FLX does not recognize the command line syntax. 
Reenter the command using the proper syntax. 
~~ /CO FILES FROM MT: NOT ALLOWED UNLESS BL: SPEC 


When transferring files from MT:, the /CO switch can be specified 
only when the /BL switch is also specified. 


Reenter the command specifying the /BL switch. 
-~- * IN OUTPUT UIC NOT ALLOWED 
The ufd field of the output file contains a wild card. 


Reenter the command with the output file ufd explicitly 
specified. 


~- * IN VERSION NUMBER NOT ALLOWED 


A wild card was detected in the version number field of a file 
specifier. 


Reenter the command with all version numbers explicitly 
specified. 


APPENDIX D 


DMP COMMAND SUMMARY AND ERROR MESSAGES 


D.1 DMP COMMAND SUMMARY 
The DMP utility has one command. 
outfile=infile/switch 


where switch = AS 


BAznsm 


BL:n:m 
BY 
HD 
ID 


LB 


MD [:n] 


D.2 DMP ERROR MESSAGES 


DMP ~~ BAD DEVICE NAME 


Dump a file onto the printer. 


Data should be dumped in ASCII 
mode. 


Specifies a base block address. 


Specifies the first and last 
logical blocks to be dumped. 


Data should be dumped in byte octal 


format. 


Includes the file header in the 
data dumped. 


Causes the current version of DMP 
to be printed on the listing. 


Causes starting (logical) block 
number and a contiguous Or 
non-contiguous indication for the 
file to be printed. 


Controls line number sequencing 
during a memory image dump. 


The user has specified an illegal device in a filespecifier. 


Reenter the command specifying the correct device. 


DMP ~- BLOCK SWITCH REQUIRED IN LOGICAL BLOCK MODE 


Self-explanatory -- /BL switch must be specified. 


Reenter the command with the /BL switch specified. 


D-1 


DMP 


DMP 


DMP 


DMP 


DMP 


DMP 


DMP 


DMP 


DMP 
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~- CANNOT FIND INPUT FILE 

The reguested file cannot be located in the specified directory. 
Reenter the command with the correct filename and ufd specified. 
-~ COMMAND SYNTAX ERROR 


The user has entered a command in a format that does not conform 
with syntax rules. 


Reenter the command with the correct syntax. 

~- FAILED TO ASSIGN LUN 

The user has specified an illegal device in a file specifier. 
Reenter the command with the correct device specified. 

~- FAILED TO READ ATTRIBUTES 


The user has attempted to access a file for which he does not 
have read access privileges. 


Rerun DMP under the correct UIC. 
-- ILLEGAL SWITCH 
The user has specified a switch that is not a valid DMP switch. 
Reenter the command with the correct switch specified. 
~- I/O ERROR ON INPUT FILE 
Or 
-~ I/O ERROR ON OUTPUT FILE 


An error has occurred during I/O to the file, e.g., the device is 
off-line. 


Correct the situation and retry the command. 
~~ NO INPUT FILE SPECIFIED 


The user has terminated a command without entering an input file 
specifier. 


Reenter the command with an input file specified. 
-- NO LISTS OR WILD CARDS ALLOWED 


The user either entered a command with more than one input or 
output filename or entered a wild card in a file specifier. 


Reenter the command with only one input file specifier and one 
output file specifier -- No wild card specifiers allowed. 
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DMP -- OPEN FAILURE ON INDIRECT FILE 


The requested indirect command file does not exist as specified. 
One of the following conditions exists. 


1. The user directory area is protected against an open. (The 
user's UIC is not recognized by the RSX-11D Executive as 
being valid for that user directory area.) 


2. A problem exists on the physical device (e.g., device cycled 
down). 


3. The volume is not mounted. 
4. The specified file directory does not exist. 


5. The file does not exist as specified. 


1. Determine which of the above conditions exists. 
2. Rectify the condition. 
3. Reenter the command. 
DMP ~-—- OPEN FAILURE ON INPUT FILE 
or 
DMP ~~ OPEN FAILURE ON OUTPUT FILE 
One of the following conditions exists: 
1. The named file doesn't exist as specified. 
2. The volume hasn't been mounted. 
3. The specified file directory does not exist. 
4. A problem exists on the physical device (e.g., device cycled 
down). 
1. Determine which condition exists. 
2. Rectify the condition. 


3. Rerun DMP. 


APPENDIX E 


EDI COMMAND SUMMARY AND ERROR MESSAGES 


E.1 EDI COMMAND SUMMARY 


ADD 
A[DD] string 


ADD AND PRINT 
AP string 


BEGIN 
B[EGIN] 


BLOCK ON or OFF 
BL[OCK] [ON] or [OFF] 


BOTTOM 
BO [TTOM] 


CHANGE 


[n] C[HANGE]/string-1/string-2 


CLOSE 
CL[OSE] filespec 


CLOSES 
CLOSES 


Add the text 
"string" to 
current line. 


specified by 
the end of the 


Same as ADD, except the new 
current line is printed out. 


Sets the current line pointer 
to the top of the block 
buffer or input file. 


Switch editing modes. 


Sets the current line pointer 
to the bottom of block buffer 
or input file. 


Search for string-1l and 
replace it with the text 
specified in string-2. n 
allows the user to repeat the 
command, thus allowing 
string-2 to be substituted 


for string-l n times. 


Transfer the remaining lines 


in the block buffer and the 
input file into the output 
file, then close both the 
input file and the output 
file. 

Close secondary input file, 
and begin selecting lines 


from the input file. 
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CLCSE AND DELETE 
CDL filespec 


CONCATENATION CHARACTER 
CC character 


CTRL/Z 
“Z 


DELETE 
D[ELETE] [n] or [-n] 


DELETE AND PRINT 
DP{n] or [-n] 


END 
E [ND] 


ERASE 
ERASE [n] 


EXIT 
EX[IT] 


EXIT AND DELETE 
EDX filespec 


EXIT TO BATCH 
EB 


FORM FEED 
FF 


FILE 
FI[LE] filespec 


Same as the CLOSE command 
except that the input file is 
deleted. 


Change command concatenation 
character to the specified 
character (default is &). 


Same as EXIT if in Edit Mode; 
otherwise, it causes an 
immediate exit of EDI. 


Delete the current and next 
n-l lines, if n is positive; 
delete n lines preceding’ the 
current line, but not the 
current line, if n is 
negative. 


Same as DELETE except that 
the new current line is 
printed out. 


Same as the BOTTOM command. 


Erase the entire block 
buffer, the current line, and 
the next n blocks. 


Same as CLOSE command except 
that when files are closed, 
EDI exits. 


Exit from the editing 
session, close the output 
file, delete the input file. 


Input and output files are 
closed. Output file is 
delivered to Batch as an 
input job. 


Insert form feed into block 
buffer. 


Transfer lines from the input 
file to the file specified by 
filespec. 
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FIND : 
[In] F[IND] string 


INSERT 
I{NSERT] [String] 


KILL 
KILL 


LINE CHANGE 
{n] LC/string-l/string~2 


LIST ON LINE PRINTER 
LP 


LIST ON TERMINAL 
LI[ST] 


LOCATE 
[n] L[OCATE] string 


MACRO 
MA[CRO] x definition 


MACRO CALL 
MC [ALL] 


MACRO EXECUTE 
nM[{xJa 


MACRO IMMEDIATE 
n<definition> 


Find the line starting with 
"string" Or, if n is 
specified the nth line 
starting with "string". 


Insert "string" immediately 
following the current line. 
If “string" is null, EDI 
enters Input Mode. 


Terminate this editing 
session; close input = and 
output files; delete the 
output file. 


Same as CHANGE except’ that 
all occurrences of string-l 
in the current line are 
changed to string-2. 


List the text in the block 
buffer or input file on the 
line printer, starting with 
the current line. 


Print on user terminal all 
lines in block buffer or all 
remaining lines in input 
file, starting at +n current 
line. 


Search the block buffer for 
"string" Or, if n is 
specified, the nth occurrence 
of "string". 


Define macro x to be 
"definition". 


Define macros from the file 
MCALL. 


Execute Macro x for n 
executions passing it the 
numeric argument a. 


Immediate Macro - this allows 
the user to define and 
execute a macro in one step. 
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NEXT 
N[EXT] [n] or [-n] 


NEXT PRINT 
NP[n] or [-n] 


OLD PAGE 
OL[DCPAGE] n 


OPENS 
OPENS filespec 


OUTPUT ON or OFF 
OU[TPUT] [ON] or [OFF] 


OVERLAY 
O[VERLAY] [n] 


PAGE 
PAG [E] [n] 


PAGE FIND 
{[n] PF[IND] string 


PAGE LOCATE 
[n] PL[OCATE] string 


PASTE 


PA[STE]/string-l/string-2 


PRINT 
P[RINT] [n] 


READ 
REA[D] [n] 


Establish a new current 
line + or - n lines from the 
current line. 


Next Print; same as Next 
command, but the new current 
line is printed out. 


Back up to page n. 
Open secondary input file. 
Turn output on or off. 


Delete the current line and 
the next n-l lines, and enter 
Input Mode. 


Enter Block Data Mode, if not 
already in Block Data Mode, 
and read page n into’ the 
block buffer. 


Identical to FIND command 
except that it searches 
successive pages until the 
nth occurrence of "String" is 
found. 


Same as LOCATE command, 
except that successive pages 
are searched for the value 
specified by "string". 


The same as the LINE CHANGE 
command except that all lines 
in the remainder of the input 
file or block buffer are 
searched for string-l. 
Wherever found, string-l is 
replaced with string-2. 


Print out the next line, and 
the next n-l lines, on the 
terminal. 


Read the next n pages’ into 
the block buffer. 
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RENEW 
REN [EW] [n] 


RETYPE 
R[ETYPE] [string] 


SAVE 
SA[VE] [n] [filespec] 


SEARCH & CHANGE 
SC/string-l/string-2 


SELECT PRIMARY 


SP 

SELECT SECONDARY 
ss 

SIZE 
SIZE n 


TAB ON or OFF 
TA[B] [ON] or [OFF] 


TOP 
T[OP] 


TOP OF FILE 
TOF 


TYPE 
TY[PE]n 


UNSAVE 
UNS [AVE] [filespec] 


Write the current buffer, end 
read in the next page. 


Replace the current line with 
the text of "string". If 
"string" is null; the line 
is deleted. 


Save the current line, and 
the next n-l lines, in the 
file specified by filespec. 


Search for string-l, in the 
block buffer or input file 


starting with the line 
following the current line. 
When string-l is found, 


replace all occurrences’ in 
line with string-2. 


Select primary input file. 


Select secondary input file. 


Specify maximum number of 
lines to be read into the 
block buffer on a sngle READ. 


Turn automatic tabbing on or 
off. 


Same as BEGIN command. 


Returns to the top of the 
input file, in Block Data 
Mode, and saves all pages 
previously edited. 


Same as PRINT command except 
that the current line pointer 
does not change. 


Retrieve the lines which were 
previously saved on filespec 
and insert them immediately 
following the current line. 
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VERIFY ON or OFF 
V[ERIFY] [ON] or [OFF] Allows user to select whether 
or not search and change 
commands are to be verified. 


WRITE 
W[RITE] Write the current block to 
the output file, and erase 
the contents of the buffer. 


E.2 EDI ERROR MESSAGES 


The four classes of EDI error messages are: 


, Command level informational and error messages 

‘ File access warning messages 

é Error messages that result in restarting the editing session 
‘ Fatal error messages that result in EDI closing all files and 


terminating its execution 


The following sections describe all the messages that may be displayed 
in each class. If the recovery procedure is not evident, a suggested 
user action is supplied. 


E.2.1 Command Level Informational and Error Messages 


Messages in this class indicate either information that is designed to 
be helpful to the user or errors that were encountered on the previous 
command. All messages in this class are enclosed within square 
brackets and are followed by a prompt for a new command. For example, 
the following output occurs if a delete command encounters an 
end-of-buffer in block mode. 


[EDI -- *EOB*] 
* 


Note that immediately following the message, EDI outputs an asterisk 
to prompt for the next command. 


The messages in this class follow. 


[EDI ~~ ALREADY PASSED THAT PAGE! ] 


The user has attempted to access a page number that is less’ than 
the current page. Prior pages can be accessed only via the 
OLDPAGE command. 


If the PAGE command has been incorrectly entered, retype the 
command with the proper page number. Else use an OLDPAGE command 
to access the desired page. 


[EDI 
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~~ BUFFER CAPACITY EXCEEDED BY] 


offending line 


[LINE DELETED] 


[EDI 


[EDI 


A READ, UNSAVE, INSERT, or OVERLAY command has caused _ the 
capacity of the block buffer to be exceeded. The line that 
caused the overflow is displayed and deleted. 


If a new file is being created, empty the buffer with a WRITE 
command and continue the editing session. 


If an existing file is being edited, it may be possible to 
continue via a RENEW or WRITE command. Otherwise use the CLOSE 
command to close the output file and save all edits. Reopen’ the 
output file as the input file and using the SIZE command, reduce 
the number of lines read into each buffer; then, using the PAGE 
LOCATE command, search to the position in the file where editing 
is to continue. 


Occasionally a file that was not created by EDI causes’ this 
message (i.e., an attempt to open the file for input produces 
this message). If this occurs, the following procedure may be 
used to successfully edit the file. 


1. Start the editing session by specifying a filename that does 
not correspond to any file in the current directory. This 
causes EDI to create a new file and enter input mode. 


2. Type carriage return to enter edit mode. 


3. Using the SIZE command, reduce the number of lines read _ into 
each buffer. 


4. Use the KILL command to terminate the creation of the file. 


5. When EDI prompts for a new file specification, enter the name 
of the desired file. 


~~ CONCATENATING CHAR CHANGED TO "&"] 


The user has changed the command concatenation character and an 
OLDPAGE, TOF, or TYPE command has caused it to be changed back to 
ee 


Use the CC command to reestablish the desired command 
concatenation character. 


~~ CREATING NEW FILE] 


The input file specified in the command does not exist and _ EDI 
has created a new file. EDI automatically enters Input mode and 
awaits the input of text lines. 


If the intent is to create a new file, continue the editing 
session entering new lines as required. Otherwise, enter Edit 
mode by typing carriage return; use the KILL command to 
terminate the creation of the new file; and when EDI prompts for 
a new file specification, enter the correct file specification. 


[EDI 


[EDI 


[EDI 


[EDI 


[EDT 


[EDI 


[EDT 


[EDI 


[EDI 
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~~ ILL CMD] 

A command that is not recognized by EDI has been entered; or a 
command that iS not compatible with the current edit mcede has 
been attempted (e.g., a READ command in line-by-line data mode). 
-~ ILL NUM] 

A non-numeric character has been specified in a numeric field or 
a negative number has been entered where only positive numbers 
are allowed. 

-- ILL STRING CONST] 


A search string specified in a CHANGE, LC, PASTE, or SC command 
contains only one command concatenation character, or does not 
contain a matching string termination character (e.g., 
PASTE/ALPHABETA whereas PASTE/ALPHA/BETA is correct). 


~- ILLEGAL IN BLOCK ON MODE] 


An attempt has been made to execute a command that is illegal in 
block mode (e.g., an OUTPUT ON or OFF command). 


--~ ILLEGAL FILE NAME GIVEN IN CLOSE OR EXIT] 

-~- FILE WAS NOT RENAMED] 

A syntactically incorrect file specifier has been given in a 
CLOSE or EXIT command or the attempt to rename the output file 
has failed. 

The output file is closed under the name of the input file 
without any loss of information. The Peripheral Interchange 
Program (PIP) can be used to rename the file to the desired name. 


~~ MACRO NOT DEFINED] 


An attempt has been made to execute a macro with the M command, 
but the specified macro has not been defined. 


Use the MACRO command to define the desired macro and then 
execute it with the M command. 


~~ MACRO NUMERIC ARG UNDEFINED] 


A macro has been executed with an M command that did not’ contain 
a numeric argument and the body of the referenced macro contains 
the numeric argument replacement character "%". 


Retype the command specifying the appropriate numeric argument. 


~~ MCALL FILE DOES NOT EXIST] 


An MCALL command has been executed to define a set of macros, but 
the file MCALL does not exist in the current directory. 


The desired set of macro definitions may exist under another UIC. 
If this is the case, use PIP to copy or rename the MCALL file 
into the current directory. 


{EDI 


[EDT 


[EDI 


[EDI 


[EDI 


[EDI 


[EDI 


[EDI 
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~~ NO INPUT FILE OPEN] 


A PAGE, READ or RENEW command has been attempted and a new file 
is being created. These commands can be executed only when an 
input file is being edited. 


-- NO MATCH] 


A CHANGE command has specified a string to be changed that is not 
in the current line. 


~- OVERLAYING PREVIOUSLY DEFINED MACRO] 


A MACRO command has resulted in the redefinition of a previously 
defined macro. This message is merely to make the user aware 
that the previous definition is no longer in effect. 


-- SAVE FILE DOES NOT EXIST] 


A file was specified in an UNSAVE command that cannot be located 
in the respective directory. 


Examine the file specifier to ensure its correctness. If the 
filespecifier is in error, correct the error, then retry the 
command. 


--~ SECONDARY FILE ALREADY OPEN] 


An attempt has been made to open a secondary input file when 
another secondary input file is already open. Alternatively, a 
CLOSE or KILL command has been executed or an error has_ been 
encountered that causes EDI to restart and the secondary file is 
found to be open from the previous edit. The former case 
represents an error, whereas the latter informs the user that he 
still has a secondary file open. 


Close the secondary input file using the CLOSES command, and then 
open the desired secondary file with the OPENS command. 


~~ SECONDARY FILE CURRENTLY SELECTED FOR INPUT] 

A CLOSE or KILL command has been issued or an error has _ caused 
EDI to restart, when the secondary input file is open and 
selected for input. 

Issue an SP command, CLOSES command and proceed. 

~~ SYNTAX ERROR] 

A command has been entered that is syntactically incorrect. 

-- TOO MANY CHARS] 

A CHANGE, LC, PASTE, or SC command has resulted in a line that 
contains too many characters. EDI limits the length of a line to 


132 characters. 


Retype the line to ensure that the line is valid. 


EDI COMMAND SUMMARY AND ERROR MESSAGES 


[EDI ~~ *BOB*] 
The beginning-of-buffer has been reached. The current line 
pointer points to just before the first line in the buffer. Thus 
new text lines can be entered before the first line. 


[EDI -- *ECB*] 


The end-of-buffer has been reached. The current line pointer now 
points to the beginning of the buffer. Thus if new lines are 
inserted they appear before the first line in the buffer. 


[EDI -- *EOF*] 
The end-of-file has been reached on the input file. 
If the editing session is complete, use the CLOSE or EXIT command 
to close the output file. Otherwise use the TOF command to 


return to the first block in the file and then continue editing 
the file. 


E.2.2 File Access Warning Messages 

Messages in this class represent attempts on the part of the user to 
access directories, files, or devices that are not present in the host 
system. Each message is prefixed with 

EDI -== 


and after the message is displayed, EDI returns to command level _ and 
prints an asterisk to request input. 


The messages in this class follow. 
EDI -~ DEVICE NOT IN SYSTEM - TRY ANOTHER COMMAND 


A FILE, OPENS, SAVE, or UNSAVE command contains the specification 
of a device that does not exist in the host system. 


Reissue the command, specifying only devices available on _ the 
system. 


EDI -~ FILE DOES NOT EXIST 


An attempt has been made in a FILE or SAVE command to create a 
file under a ufd that has no directory on the specified volume. 


WARNING 


The remaining error messages in this class’ should not 
occur and represent failures in EDI. If such errors 
persist, consult your DEC software support 
representative. 
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EDI -- BAD DEVICE NAME 

EDI ~- BAD FILE NAME 

EDI -- DEVICE NOT READY 

EDI -- FILE ALREADY OPEN 

EDI -~- RENAME NAME ALREADY IN USE 

EDI -- RENAME ON TWO DIFFERENT DEVICES 
EDI -~- WRITE ATTEMPT TC LOCKED UNIT 


E.2.3 Error Messages That Result in Restarting the Editing Sessions 


The error messages described in this section are caused by conditions 
encountered by EDI that make it impossible to continue the current 
editing session. EDI closes all open files (with the exception of the 
secondary input file), reinitializes, and then prompts for the next 
file to be edited. 


As with file access warning messages, each message in this class is 
prefixed with: 


EDI --~ 
After the appropriate message has been displayed, EDI prompts with: 
EDI> 


The editing session may be terminated at this point by typing carriage 
return or can be continued by entering the next file specifier. If a 
secondary file was open when error condition was encountered, the 
secondary file must be closed using the EDI commands. The messages in 
this class follow. 


EDI -- BAD RECORD TYPE-FILE NO LONGER USABLE 


The record type defined in the header block of the input file 
(primary input, secondary input, UNSAVE, or MCALL) is not 
supported by File Control Services (FCS) and thus the file cannot 
be used for input to EDI. 


The referenced file has been created without using FCS or _ the 
file structure on the volume is damaged. If the latter is the 
case, the disk structure verification program VFY should be run 
to determine the extent of the damage. 


EDI -- FILE IS ACCESSED FOR WRITE 


The input file (primary input, secondary input, UNSAVE, or MCALL) 
is currently being written by another task. 


Wait for the file to be written and then retry the command. 
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EDI -- FILE IS LOCKED TO WRITE ACCESS 


The output file (text output, FILE, or SAVE) is currently 
accessed for shared read by one or more tasks and is locked 
against all writers. 


Wait for all readers of the file to finish, then retry the 
command. 


EDI ~- TLLEGAL RECORD ATTRIBUTES ~ FILE NOT USABLE 


The record attributes defined in the header block of the input 
file (primary input, secondary input, UNSAVE, or MCALL) are not 
supported by FCS and thus the file cannot be used for input to 
EDI. 


The referenced file has been created without using FCS or _ the 
file structure on the volume is damaged. If the latter is the 
case, VFY should be run to determine the extent of the damage. 


EDI -- PRIMARY FILE NOT PROPERLY CLOSED - NOT USABLE - EDITOR 
WILL RESTART 


When the primary input file was last written, a close chech was 
specified and the writing task did not properly close the file 
(e.g., the task was aborted.) Thus the file attributes were not 
written and the file may contain inconsistent data. 


Exit from EDI by typing carriage return. Run the peripheral 
interchange program (PIP) and use the /UN switch to unlock the 
File. Reinitiate EDI and try to recover the data in the file. 


EDT ~- PRIVILEGE VIOLATION 


A privilege violation occurs during a file access for the 
following reasons: 


l. The specified volume is not mounted. 


2. The UIC under which EDI is running does not possess’ the 
necessary privileges to access the specified directory. 


3. The UIC under which EDI is running does not possess’ the 
necessary privileges to access the specified file. 


Exit from EDI by typing CTRL Z. Determine the cause of the 
privilege violation. If the volume is not mounted, then mount it 
using the MCR MOUNT command. Otherwise reinitiate EDI under a 
UIC that has appropriate access privileges to both the specified 
directory and the file. 


EDI ~- RECORD IS TOO LARGE FOR USER BUFFER 


The input file (primary input, secondary input, UNSAVE, or MCALL) 
being accessed was not created by EDI (or SLP) and contains 
records that are too large. The maximum record length supported 
by EDI is 132 bytes. 
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EDI ~~ SECONDARY FILE NOT PROPERLY CLOSED -—- NOT USABLE 


When the secondary input file was last written, a close check was 
specified and the writing task did not properly close the file 
(e.g., the task was aborted). Thus the file attributes were not 
written and the file may contain inconsistent data. 


Exit from EDI by typing carriage return. Run PIP and use the /UN 
switch to unlock the file. Reinitiate EDI and try to recover the 
Gata in the file. 


WARNING 


The remaining error messages in this class should not 
occur and represent failures in EDI. if such errors 
persist consult your DEC software support representative. 


EDI -- BAD DIRECTORY SYNTAX 

EDI -- DUPLICATE ENTRY IN DIRECTORY 

EDI -- END OF FILE 

EDI --~ ILLEGAL RECORD ACCESS BITS - FILE NOT USABLE 
EDI -~ ILLEGAL RECORD NUMBER ~- FILE NOT USABLE 


E.2.6 Fatal Error Messages that Result in EDI Closing All Files’ and 
Terminating Its Execution ~- The fatal error messages represent system 
and/or hardware error conditions which make it impossible for EDI to 
continue execution. All files are closed and EDI terminates its 
execution. The output file may be truncated. Each error -message is 
prefixed with: 


EDI -- 

and followed by the exit message: 

[EDI -~ EXIT] 

on the next line. 

The advanced user can utilize the truncated version of an output file 
in the following manner’ to save the editing performed prior to the 


fatal error condition 


1. Use PIP to rename the truncated version of the output file to 
avoid confusion. 


2. Restart the editing session on the original input file. 


3. Issue an OPENS command specifying the renamed file as_ the 
secondary file. 


4. Issue an SS command to select the secondary file for input. 
5. Issue an ERASE command to erase the first block of the input 


file unless the truncated output file did not contain the 
entire first block. 
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6. Issue as many READ 1 and WRITE commands as necessary to reach 
the EOF on the secondary file. 

7. j%Issue an SP command to select the primary file for input. 

8. Issue a CLOSES command to close the secondary file. 

9. Issue a WRITE command to ensure the last block was written 
into the output file. 

10. Issue as many READ 1 and ERASE commands as necessary to 
bypass all input file blocks which are complete in the 
renamed file. 

1l. Continue the normal editing session. 

The messages in this class follow. 

EDI ~~ CALLER'S NODE EXHAUSTED 
System dynamic storage has been depleted and insufficient space 
is available to allocate the control blocks necessary to open, 
close, read, or write a file. 
This probably is a system failure, but also could represent a 
transient overload condition. Wait until system load has 
diminished and reinitiate EDI. 

EDI ~- DEVICE FULL 
Insufficient space exists on the output volume to extend an 
output file (text output, FILE, or SAVE). 
Determine which volume is being written on. If it is required 
that the specified file be written on this volume, then space 
must be made available. Use PIP to purge (/PU) or delete (/DE) 
unwanted files. 

EDI -~- FILE HEADER CHECKSUM ERROR 
An input file (primary input, secondary input, UNSAVE, or MCALL) 
has a header block that does not contain a proper checksum. 
The file structure on the specified volume is damaged. Run VFY 
to determine the extent of the damage. 

EDI -- FILE HEADER FULL 


Insufficient retrieval pointer space exists in the header block 
to extend an output file (text output, FILE, or SAVE). 


An attempt is being made to create an output file that is larger 


than 


can be described ina file header block. Split the file 


into two or more files and process them separately. 
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EDI -~- INDEX FILE FULL 


EDI 


EDI 


EDI 


BDI 


EDI 


EDI 


EDI 


EDI 


EDI 


EDI 


EDI 


EDI 


File header block is not available to create an output file (text 
output, FILE, or SAVE). When a volume is initialized, the 
Maximum number of files that may be created on the volume is 
established. An attempt has been made to exceed this maximum. 


Determine which volume is being referenced. If it is required 
that the specified file be created on this volume, then space 
must be made available. Use PIP to purge (/PU) or delete (/DE) 
unwanted files. 


WARNING 


The following error messages’ signify 
hardware problems. If possible, all 
important files should be removed _ from 
the volume. If errors persist, consult 
the DEC field service representative. 


~~ BAD BLOCK ON DEVICE 


~~ FILE PROCESSOR DEVICE READ ERROR 
-- FILE PROCESSOR DEVICE WRITE ERROR 
-~- HARDWARE ERROR ON DEVICE 


-- PARITY ERROR ON DEVICE 


WARNING 


The remaining error messages in this 
class should not occur and represent 
failures in EDI. Tf such errors 
persist, consult your DEC’ software 
Support representative. 


~- BAD DIRECTORY FILE 


~- BAD PARAMETERS ON A QIO 


-~ INVALID FUNCTION CODE ON A QIO 


-- NO BLOCKS LEFT 


~~ REQUEST TERMINATED 


-- WRITE ATTRIBUTE DATA FORMAT ERROR 


~~ UNEXPECTED ERROR - EDITOR WILL ABORT 


TASK "...EDI" TERMINATED 


APPENDIX F 
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F.1 SLP COMMAND SUMMARY 


The SLP utility has only one command. 


outfile[,listfile/SP or -SP]=infile[/switch] 


Performs batch-oriented 
editing to create and 
Maintain source language 
files on disk or _ tape 
cassette. 


where switch = AU and ~-AU Enable and disable the 
editing audit trail, 
which indicates the 
changes made during the 
most recent editing 
session. 
BF and -BF Enable and disable blank 


fill when an audit trail 
is being produced. 


DB and -DB Enable and disable double 
spaced listing. 


and where SP and -—SP Enable and disable _ the 


spooling of listing files 
to a file structure 
volume. 


F.2 SLP ERROR MESSAGES 


SLP error messages are issued in two different formats: 


SLP followed by two dashes and the error message. If 
applicable, the command line in error is printed on the next 
line. 


SLP followed by two dashes, the error message and_ the 
offending filename. 


F-1 
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EXAMPLES 


SLP -- SYNTAX ERROR 
RICKSFILE;MAC,LP:=SHIRLEY.MAC;2 


or 
SLP ~- OPEN FAILURE LINE LISTING FILE filename 


SLP error messages, descriptions, and suggested user actions are as 
follows. 


SLP ~- COMMAND SYNTAX ERROR 

command line 
A syntax error has been detected in a command. 
This error is fatal, and causes the editing session to be 
reinitialized. That is, the user must re-specify the file 
specifier correctly. 

SLP -- ILLEGAL DEVICE NAME 


command line 


The device specified is not a legal device. This is ae fatal 
error; it causes the editing session to be reinitialized. 


Re-specify the file specifier correctly. 

SLP -- ILLEGAL DIRECTORY 

command line segment 
The directory (ufd) specified is not legally specified. This is 
a fatal error; it causes the editing session to be 
reinitialized. 
Re-specify the file specifier correctly. 

SLP -~ ILLEGAL ERROR/SEVERITY CODE pl p2 p3 


This error indicates an error in the SLP program. 


Retry the command. If the error persists, contact your DEC field 
support representative. 


SLP -- ILLEGAL FILE NAME 

command line segment 
A file specification is greater than 30 characters in length or 
contains a wild card (i.e., an asterisk in place of a file 
specification element). This is a fatal error; it causes’ the 


editing session to be reinitialized. 


Re-specify the file specifier correctly. 
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SLP -- ILLEGAL GET COMMAND LINE ERROR 
This error indicates an error in the SLP program. 


Retry the command. If the error persists, contact your DEC field 
support representative. 


SLP -- ILLEGAL SWITCH 
command line segment 


The switch is not a legal SLP switch. This is a fatal error; it 
causes the editing session to be reinitialized. 


Re-enter command line with correct switch specified. 

SLP -- INDIRECT COMMAND SYNTAX ERROR 

command line 
The filename specified for the indirect file does not adhere to 
the proper syntax. This is a fatal error; the currently opened 
files are closed, and SLP is reinitialized. 
Respecify the indirect file specifier correctly. 

SLP -- INDIRECT FILE DEPTH EXCEEDED 

command line 
More than two indirect files have been specified. This is a 
fatal error; the currently opened files are closed and SLP is 
reinitialized. 
Respecify the indirect file specifier correctly. 

SLP ~~ INDIRECT FILE OPEN FAILURE 

command line 
The indirect file can't be found on the specified volume. This 
is a fatal error; the currently opened files are closed and SLP 
reinitializes. 
a. Respecify the file specifier correctly. 
b. Ensure that the volume is on line and mounted. 

SLP -- I/O ERROR COMMAND INPUT FILE 
An attempt to read command input has failed. 


a. Ensure that the volume is on line and mounted. 


b. Retry the command. 
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SLP -- I/O ERROR COMMAND OUTPUT FILE 
An attempt to write command output (i.e., an error message) has 
failed. 
a. Ensure that the volume is online and mounted. 
b. Retry the command. 
SLP ~~ I/O ERROR CORRECTION INPUT FILE filename 


An I/O error has been detected during a read of the correction 
input file. 


a. Insure that the volume is online and mounted. 
b. Retry the command. 
SLP -~ I/O ERROR LINE LISTING FILE filename 
An error has been detected during the writing of the line listing 
file. Usually indicates a problem with a device (disk error, 
etc.) 
a. Ensure that the volume is online and mounted. 
b. Retry the command. 
SLP -~ I/O ERROR SOURCE OUTPUT FILE filename 


An attempt to write into the source output file has failed. 


a. Ensure that the volume is on line and mounted. 
b. Retry the command. 
SLP -- OPEN FAILURE CORRECTION INPUT FILE filename 


The specified correction input file cannot be found; one of the 
following conditions exists. 
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ay 
4. 
5. 


The user directory is protected against an open. 


There is a problem with the physical device (e.g., device not 
online). 


The volume is not mounted. 
The specified file directory does not exist. 


The file does not exist as specified. 


This is a fatal error; the currently opened files are closed and 
SLP reinitializes. 


Determine which of the above conditions exists. 
Rectify the condition. 


Respecify the file specifier correctly. 
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SLP -- OPEN FAILURE LINE LISTING FILE filename 


The file can not be opened for one of the following reasons: 


1. 


The user directory is protected against an open. 


There is a problem with the physical device (e.g., device not 
on line). 


The volume is not mounted. 
The specified file directory does not exist. 


The file does not exist as specified. 


This is a fatal error; it causes the editing session to be 
reinitialized. 


1. 
2. 


3. 


Determine which of the above conditions exists. 
Rectify the condition. 


Respecify the filespecifier correctly. 


SLP -- OPEN FAILURE SOURCE OUTPUT FILE filename 


The specified source output file can not be opened; one of the 
following conditions exists: 


ue 


The user directory is protected against an open. 


There is a problem with the physical device (e.g., device not 
on line). 


The volume is not mounted. 
The specified file directory does not exist. 


There is insufficient space on the disk. 


This is a fatal error; it causes the editing session to be 
reinitialized. 


1. 
2. 


3. 


Determine which of the above conditions exists. 
Rectify the condition. 


Respecify the file specifier correctly. 


SLP ~~ PREMATURE EOF CORRECTION INPUT FILE filename 


An out-of-range line number has been specified in a correction 


file 


or from the terminal e.g., -1000 has been specified for an 


800 line file. 


ae 


2. 


Terminate the current editing session. 


Restart the editing session, entering the correct line 
number. 
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SLP ~~ PREMATURE EOF COMMAND INPUT FILE 


This is caused by typing CTRL Z at the terminal, which sends an 
end-of-file to SLP before the / is read. SLP types out SLP>, 
indicating that a new file specification is expected. 


Restart the editing session at the point where the CTRL/Z was 
inadvertently typed. 
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G.1 LBR COMMAND SUMMARY 


COMPRESS 
outfile/CO:size:sept:mnt:=infile Physically deletes 
logically deleted records 
on a file and puts all 
free space at the end of 
the file. 
CREATE 
outfile/CR:size:ept:mnt:type Allocates a contiguous 
library file on a direct 
access device. 
DELETE 
outfile/DE:module-1 Deletes library modules 
and their 
[:module-2:...:module-n] associated entry points 


from a file. 


DELETE GLOBAL 


outfile/DG:global-1l Deletes specified library 
module entry 
[:global-2:...:global-n] points from a file. 
INSERT 
outfile/IN=infile-l Inserts library modules 
into 
[,infile-2,...,infile-n] a library file. 
LIST 
outfile[,listfile]/switch (es) 
/switch(es) =LI Lists all modules in the 


library file. 


LE Lists all modules in the 
library file and all 
their entry points. 


FU Lists all modules in the 
library file and _ their 
entry points, and 
provides a full module 
description including 
size, date of insertion, 
and version. 
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REPLACE 
outfile/RP=infile-1 Replaces, and in certain 
[,infile-2,...,infile-n] cases, inserts library 
Or modules in a library 
file. 
outfile=infile-1 [/RP] 
[,infile-2[/RP],...,infile-n[/RP] ] 
SPOOL 
outfile,listfile/SP The listing file is 


spooled out for printing. 
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G.2 LBR ERROR MESSAGES 


LBR -~ ILLEGAL GET COMMAND LINE ERROR CODE 


The system, for some reason, is unable to read a commend line. 
This is an internal system failure. 


Retry the command. 
LBR -- INPUT ERROR ON filename 


The file system, while attempting to process an input file, has 
detected an error. 


There is a problem with the physical device (e.g., device cycled 
down). 


Retry the command. 
LBR -~- COMMAND SYNTAX ERROR 
command line 


The user has entered a command in a format that does not conform 
to syntax rules. 


Reenter the command with the correct syntax. 
LBR ~- OUTPUT ERROR ON filename 


A write error has occurred on the output file. One of the 
following conditions exists. 


1. The volume is full. 
2. The device is write protected. 
3. The hardware has failed. 


If the volume is full, the user should delete any unneccessary 
files and rerun LBR. 


If the device is write protected the user should write enable the 
device, and retry the command. 


If the hardware has failed, the user can swap devices and retry, 
or wait until the device is repaired, and rerun LBR. 


LBR -- ILLEGAL SWITCH 


command line 


The user specified a non-LBR switch or a legal switch in an 
invalid context. 


Reenter the command line with the correct switch specifications. 


LBR 


LBR 


LBR 


LBR 
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~~ INSUFFICIENT DYNAMIC MEMORY TO CONTINUE 
The partition in which LBR is running is too small. 


Remove the task (LBR), install it in a larger partition, and 
retry the command. 


-- INVALID LIBRARY TYPE SPECIFIED 


The user specified an illegal library type in a CREATE command. 
OBJ is currently the only valid type. See Section 7.5.2. 


Reenter the command with OBJ specified or implied by default. 
~- COMMAND I/O ERROR 

LBR encountered an error while retrieving a command line. 
Rerun the job. 


-~ INDIRECT FILE OPEN FAILURE 


command line 


LBR 


The requested indirect command file does not exist as specified. 
One of the following conditions exists. 


1. The user directory area is protected against an OPEN. 


2. A problem exists with the physical device (e.g., device 
cycled down). 


3. The volume is not mounted. 

4. The specified file directory does not exists. 
5. The file does not exist as specified. 

1. Determine which of the above conditions exists. 
2. Rectify the condition. 

3. Reenter the command. 


-- INDIRECT COMMAND SYNTAX ERROR 


command line 


The user specified an indirect file in a format that does. not 
conform to syntax rules. 


Reenter the command with the correct syntax. 
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LBR -- BAD LIBRARY HEADER 


Either the file is not a library file, or the file is corrupted. 


1. If the file is not a librery file, retry the command with a 
proper library file specified. 

2. If the file is a proper library file, the user should run the 
VFY utility program against the volulme to determine if it is 
corrupted. 

3. If the volume is corrupted, it must be reconstructed, before 
it can be used. 

LBR ~~ INDIRECT FILE DEPTH EXCEEDED 


command line 


An attempt has been made to exceed one level of indirect command 
files. 


Rerun the job with only one level of indirect command file. 


LBR -- I/O ERROR IN INPUT FILE 


A read error has occurred on an input file. One of the following 
conditions may exist. 


1. A problem exists with the physical device (e.g., not cycled 
up). 

2. The file is corrupted or the format is wrong. (Record length 
exceeds 132 bytes.) 

3. The file is a non-object file. (Source file, etc.) 

1. Determine which of the above conditions exists. 

2. Rectify the condition. 

3. Reenter the command. 

LBR -- OPEN FAILURE ON FILE filename 


The file system, while attempting to open a file, has detected an 
error. One of the following conditions may exist. 


1. 


The user directory area is protected against an open. 


A problem exists with the physical device (e.g., device 
cycled down). 


The volume is not mounted. 
The specified file directory does not exist. 
The file does not exist as specified. 


Insufficient contiguous space to allocate the file. 
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1. Determine which of the above conditions exists. 
2. Rectify the condition. 
3. Reenter the command. 

LBR -= INVALID EPT AND/OR MNT SPECIFICATION 


The user, when specifying a /CR or /CO command, entered an EPT or 
MNT value which was greater than 4096. 


Retry the command with the correct value specified. 


LBR -- POSITIONING ERROR ON filename 


The device is write-locked. 


If the device is write-locked, write-enable it and retry. 


LBR -- EPT OR MNT EXCEEDED IN filename 


The EPT or MNT table limit has been reached Curing the execution 
of an Insert or Replace command. 


1. Copy the library, increasing the table space, using’ the 
COMPRESS command. 
2. Retry the command. 
LBR -- DUPLICATE MODULE NAME "name" IN filename 


An attempt has been made to insert (without replacement) a module 


into a library that already contains a module with the specified 

name. 

1. Determine if the specified input file is the correct file. 

2. If the input file is correct, the user must decide whether to 
delete the duplicate module from the library file and insert 
the new one. or replace the duplicate module by rerunning 
LBR with the /RP switch appended to the input file specifier. 

LBR -- GET TIME FAILED 


This error occurs when LBR attempts to execute a GET Time 
Parameters directive and fails. The error is caused by some 
system malfunction. 


Retry the command. 


LBR -- NO MODULE NAMED "module" 


The user has attempted to delete a module that is not in the 
specified library file. 


28 


2. 


Determine if the module name is misspelled, or if the wrong 
library file is specified. 


Retry the command with module name correctly specified. 
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LBR -~ INVALID NAME -- "name" 
A module name or entry point that contains a non~-Radix-50 
character has been specified for deletion. 
NOTE 

Radix-50 characters consist of the letters of the 
alphabet A through Z, the numbers 0 through 9, and the 
special characters period (.) and dollar sign ($). 

Retry the command with a valid name. 


LBR ~- LIBRARY FILE SPECIFICATION MISSING 


The user has entered a command without specifying the library 
file. 


Retry the command with the library file specified. 
LBR -- ILLEGAL SWITCH COMBINATION 


The user has specified switches that cannot be executed in 
combination. See Section 7.6. 


Retry with command switches in the proper sequence. 
LBR ~~ NO ENTRY POINT NAMED name 


The user has attempted to delete an entry point that is not in 
the specified library file. 


1. Determine if the entry point is misspelled, or if the wrong 
library file is specified. 


2. Retry the command with the entry point correctly specified. 
LBR ~~ DUPLICATE ENTRY POINT NAMED "name" IN filename 


An attempt has been made to insert a module into a library file 
when both contain an identically named entry point. 


1. Determine if the specified input file is the correct file. 
If not, retry with the correct input file specified. 


2. If the input file is the correct file, the user may delete 
the duplicate entry point from the library and rerun. 


LBR -- TOO MANY OUTPUT FILES SPECIFIED 


The user has specified more than two output files. LBR makes the 
following assumptions: 


1. The first output file specified is the output library file. 
2. The second output file specified is the listing file. 


3. The third through n files specified to the left of the equal 
sign are ignored. 


No action is required. LBR continues as though the extra file(s) 
were not specified. 


LBR 


LBR 


LBR 


LBR 


LBR 
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-- I/O ERROR ON OUTPUT FILE 


A write error has occurred on the output file. One of the 
following conditions exists. 


l. The volume is full. 

2. The hardware has failed. 

3. The device is write protected. 

4. The user does not have write access privileges to the file. 


If the volume is full, the user should delete any unnecessary 
files, and retry the command. 


If the hardware has failed, the user can swap devices and retry 
the command, or wait until the device is repaired, and retry the 
command. 


If the device is write protected, the user should write enable 
it, and retry the command. 


If the user does not have write access, consult the System 
Administrator who can take necessary action. 


-~ EXACTLY ONE INPUT FILE MUST APPEAR WITH /CO 


The user has specified no file or more than one input library 
file in the /CO command. 


Retry the command with only one input file specified. 
~- FATAL COMPRESS ERROR 


The user's input library file is corrupted or is not a library 
file. 


No recovery is possible. The file in question must be 
reconstructed. 


~~ EPT OR MNT SPACE EXCEEDED IN COMPRESS 
The user has specified an EPT or MNT table size for the output 
library file that is not large enough to contain the EPT or MNT 


entries used in the input library file. 


Reenter the command with a larger EPT or MNT table size 
specified. 


~~ ERROR IN LIBRARY TABLES, FILE filename 
The library file is corrupted, or is a non-library file. 


If the file is corrupted no restart is possible; the file must 
be reconstructed. 


If the file is a non-library file, the user should retry the 
command with the correct library file specified. 
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LBR ~~ INVALID FORMAT, INPUT FILE filename 


The specified input file is not a standard format object file or 
the input file is corrupted. 


Reenter the command with the correct input file specified. 
LBR ~~ OPEN FAILURE ON LBR WORK FILE 
The file system, while attempting to open the LBR work file, has 
detected an error. 
NOTE 
The LBR work file is created on the volume from which LBR 
was installed. 
One of the following conditions exists: 
1. The volume is full. 
2. The device is write protected. 


3. A problem exists with the physical device. 


1. Determine which of the above conditions exists. 
2. Rectify the condition. 
3. Retry the command. 
LBR -- MARK FOR DELETE FAILURE ON LBR WORK FILE 
When LBR begins processing commands, it automatically creates a 
work file, and automatically marks it for delete. For some 


reason, this marking for delete failed. 


The work file constitutes a lost file, because it does not appear 
in any file directory. 


The file may be deleted by running the utility (See Chapter 9). 
LBR ~- ILLEGAL FILENAME 
command line 
The user has entered one of the following: 
l. A file specifier which contains a wild card. 
2. A file specifier which does not contain a filename or type. 
Reenter the command correctly. 
LBR ~~ ILLEGAL DEVICE/VOLUME 
command line 


The device specifier does not conform to the proper syntax. 
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NOTE 


A device specifier consists of 2 ASCII characters 
followed by one or two octal digits. 


Retry the command with the correct device syntax specified. 
LBR -- ILLEGAL DIRECTORY 
command line 
The ufd field in a file specifier does not conform to the proper 
syntax. 
NOTE 
ufd syntax consists of a left square bracket, followed by 
one to three octal digits, followed by a comma, followed 


by one to three octal digits, followed by a right square 
bracket. 


Retry the command with the correct ufd syntax. 
LBR ~~ WORK FILE I/O ERROR 


A write error has occurred on the LBR work file. One of the 
following conditions exists. 


1. The volume is full. 
2. The device is write protected. 
3. The hardware has failed. 


If the volume is full, the user should delete any unnecessary 
files and rerun. 


If the device is write protected, the user should write enable 
the device, and retry the command. 


If the hardware has failed, the user can swap devices and retry, 
Or wait until the device is repaired and rerun LBR. 


LBR -- VIRTUAL STORAGE REQUIREMENTS EXCEED 65536 WORDS 


This error may occur with maximum size libraries and aé_e single 
command line which logically deletes a large number of modules 
and entry points, and continues to replace them with an equally 
large number of modules and entry points having highly dissimilar 
names. 


Normally, this message indicates some sort of internal system 
error. 


Rerun the job, but divide the complicated command line into 
several smaller command lines which do the same operations. 


H.1 


The 
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SQZ COMMAND SUMMARY 


Squeeze utility has only one command. 


SQZ outfile=infile-l 


Reduces the size of 
[,infile-2,...,infile-n] programs. 


H.2 SQZ ERROR MESSAGES 
SQZ -- INDIRECT FILE OPEN FAILURE 
The requested indirect command file does not exist as specified. 
One of the following conditions exists. 
l. The user directory file is protected against an open. 
2. A problem exists with the physical device (e.g., device 
cycled down). 
3. The volume is not mounted. 
4. The specified file directory does not exist. 
5. The file does not exist as specified. 
l. Determine which of the above conditions exists. 
2. Rectify the condition. 
3. Reenter the command. 
SQZ -- INDIRECT COMMAND SYNTAX ERROR 
The user has specified an indirect file in a format that does not 
conform to syntax rules. 
Reenter the command with the correct syntax. 
SQZ -- INDIRECT FILE DEPTH EXCEEDED 


The maximum depth of indirect command files is one level. An 


attempt 


the current depth of indirect command is already one. 


Rerun the job with one level of indirect files. 


1 


has been made to reference an indirect command file when 


SQzZ 


SQZ 


SQZ 


SQzZ 


SQZ 
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~~ COMMAND I/O ERROR 

SQZ has encountered an error while retrieving a command line. 
Reenter the command. 

-- COMMAND SYNTAX ERROR 


The user has entered a command in a format that does not conform 
with syntax rules. 


Reenter the command with the correct syntax. 
-~- ILLEGAL SWITCH 


The user has specified a switch where none is allowed. S@Z has 
no switches, therefore, any switch specification is illegal. 


Reenter the command without switch specifications. 
~~ ILLEGAL FILE SPECIFICATION 

The user has entered one of the following: 

1. A file specifier which contains a wild card. 

2. A file specifier which does not contain a filename or type. 
1. Examine the command in error. 

2. Reenter the command correctly. 
~~ OUTPUT FILE OPEN ERROR 

The file system, while attempting to open the output file 
(SQZ.TMP), has detected an error. One of the following 
conditions may exist. 

1. The user directory file is protected against an open. (The 

user's UIC is not recognized by the RSX-11D Executive as 


being valid for that user directory area.) 


2. A problem exists with the physical device (e.g., device 
cycled down). 


3. The volume is not mounted. 

4. The specified file directory does not exist. 

5. The device is full or write protected. 

1. Determine which of the above conditions exists. 
2. Rectify the condition. 


3. Reenter the command. 
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SQZ -- OUTPUT FILE T/O ERROR 


A write error has occurred on the output file. One of the 
following conditions exists. 


1. 


2. 


The device is full or is write protected. 


The hardware has failed. 


NOTE 


The file SQZ.TMP remains intact. 


If the volume is full, delete any unnecessary files and rerun 


SQZ. 


If a hardware error has occurred, swap devices and rerun SQZ, or 
wait until the device is repaired, and rerun SQZ. 


SQZ -- OUTPUT FILE RENAME ERROR 


SCZ has failed in its attempt to rename the SQZ.TMP file to the 


name 


specified in the output file specifier. SQZ restarts and 


the SQZ.TMP file remains intact. 


Rename the SQZ.TMP file to the desired name by using the PIP 
utility program. 


SQZ ~- 


INPUT FILE OPEN FAILURE 


The file system, while attempting to open an input file, has 
Getected an error. One of the following conditions may exist. 


a 


The user directory file is protected against an open. (The 
user's UIC is not recognized by the RSX-11D Executive as 
being valid for that user directory area). 


A problem exists with the physical device (e.g., device 
cycled down). 


The volume is not mounted. 

The specified file directory does not exist. 
The file does not exist as specified. 

Determine which of the above conditions exists. 
Rectify the condition. 


Reenter the command. 
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SQZ -- INPUT FILE I/O ERROR 


A read error has occurred on an input file. One of the following 
conditions may exist. 


1. A problem exists with the physical device (e.g., device 
cycled down). 


2. The file is corrupted or the format is wrong (line length 
exceeds 132 bytes). 


3. The file is a nonsource file. (Object file, etc.) 


1. Determine which of the above conditions exists. 
2. Rectify the condition. 


3. Reenter the command. 
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VFY COMMAND SUMMARY 


DELETE 
listfile,scratchdev=indev/DE 
or indev/DE 


FREE 
listfile=indev/FR 
or indev/FR 


LIST 
listfile, scratchdev=indev/LI 
or indev/LI 


LOST 
listfile, scratchdev=indev/LO 
or indev/LO 


REBUILD 
listfile, scratchdev=indev/RE 
Or indev/RE 


UPDATE 
listfile, scratchdev=indev/UP 
or indev/UP 


READ CHECK 
listfile=dev:/RC[:n] 
or dev:/RC[:n] 


Resets the marked-for-delete 
indicators in the file header 
area of those files marked 
for deletion, but were never 
actually deleted. 


Prints out the available 
space on a volume. 


Lists the entire index file 
by file identification. 


Scans the entire file 
Structure looking for files 
that are not in any 
directory. 


Recovers blocks that appear 
to be allocated, but are not 
contained in any file. 


Allocates blocks that appear 
to be available, but are 
actually allocated to a file. 


Checks that every block 
of every file on _ specified 
volume can be read. 


VFY 


VFY 


VFY 


VFY 


VFY 


VFY 


VFY 


VFY 


VFY 
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VFY ERROR MESSAGES 


-- COMMAND SYNTAX ERROR 


The command does not conform to command syntax rules. 


Re-enter the command with the correct syntax specified. 


~~ FAILED TO ALLOCATE SPACE FOR TEMP FILE 


The volume used for the temp file is full. 


Use PIP to delete any unnecessary files, and rerun VFY. 


~- FAILED TO ATTACH DEVICE 
Or 
~~ FAILED TO DETACH DEVICE 
or 
~- ILLEGAL DEVICE 
The file specifier entered contains an illegal device. 
Reenter the command with the correct device specified. 
~~ ILLEGAL SWITCH 
The switch specified is not a valid VFY switch. 
Reenter the command with the correct switch specified. 
-~- I/O ERROR ON INPUT FILE 
or 
~~ I/O ERROR ON OUTPUT FILE 
One of the following conditions exists: 
1. The device is not online. 
2. The device is not mounted. 


3. The hardware has failed. 


l. Determine which of the above conditions exists. 
2. Rectify the condition. 
3. Rerun VFY. 
-~ NO DYNAMIC MEMORY AVAILABLE ~— PARTITION TOO SMALL 
VFY does not have enough buffer space to run. 


The system manager must rebuild VFY to increase buffer 


space. 
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VFY -- OPEN FAILURE ON BIT MAP 
or 

VFY -- OPEN FAILURE ON INDEX FILE 
or 


VFY -- OPEN FAILURE ON LISTING FILE 
or 


VEY "<= 


OPEN FAILURE ON TEMPORARY FILE 

One of the following conditions exists: 

1. VFY is not running under a system UIC, but it should be. 
2. The named file does not exist as specified. | 


3. The device has not been mounted. 


1. Determine which of the above conditions exists: 
2. Rectify the condition. 


3. Rerun VFY. 


I.2.1 VFY Error Codes 
If VFY cannot access the message files because the system device (SY:) 
is not mounted or MO is not loaded, errors are reported in the 
following format 

VFY -- ERROR CODE nn. 

where 


nn. is one of the error codes contained in Table I-l. 


Refer to Section I.2 for error description and suggested user action. 
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Table I-1l 
VFY Error Codes 


VFY ERROR MESSAGE IS: 


ILLEGAL DEVICE 

OPEN FAILURE ON BIT MAP 

OPEN FAILURE ON TEMPORARY FILE 

FAILED TO ALLOCATE SPACE FOR TEMP FILE 


FAILED TO DETACH DEVICE 

FAILED TO ATTACH DEVICE 

COMMAND SYNTAX ERROR 

I/O ERROR ON INPUT FILE 

T/O ERROR ON OUTPUT FILE 

ILLEGAL SWITCH 

OPEN FAILURE ON LISTING FILE 

OPEN FAILURE ON INDEX FILE 

NO DYNAMIC MEMORY AVAILABLE - PARTITION TOO SMALL 
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J.1 ZAP COMMAND SUMMARY 


ZAP>dev:infile[/switch] 
or 


MCR>ZAP@dev: infile[/switch] 


where switch = AB ZAP commands are treated as 
absolute byte addresses within the 

file. 
LI Line segment data is listed on user 


terminal. 


RO File is opened for read-only. 


J.2 ZAP ERROR MESSAGES 


ZAP ~- NO SUCH RELOCATION REGISTER 

Relocation registers are numbered 0 through 7. 

Retry command using the correct relocation register number. 
ZAP ~- ADDRESS NOT WITHIN SEGMENT 


The specified address was not within the overlay segment 
specified. 


Retry command using the correct address or overlay segment 
number. 


ZAP ~- NO SUCH SEGMENT 


The starting disk block was not the start of any segment in the 
task image. 


Retry command using the correct starting disk block address. 
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ZAP ~~ TOO MANY ARGUMENTS 
More arguments were given in a command than were expected. 
Retry the command using the correct command syntax. 

ZAP ~~ NO SUCH INTERNAL REGISTER 


The character following a dollar sign was not the name of an 
internal register. 


Retry command using the correct internal register name. 
ZAP -~- UNRECOGNIZED COMMAND 
Possibly, the command contained an illegal character. 
Retry command using correct command syntax. 
ZAP ~- NO OPEN LOCATION 


A modification command was given with no location open to receive 
the data. 


Open the desired location and perform modification. 
ZAP --~ CANNOT BE USED IN BYTE MODE 


The commands, @, ~ and > cannot be used when a location is open 
as a byte. 


Open location in word mode if it is an even address. 
ZAP ~~ ERROR IN FILE SPECIFICATION 
The file specification was not properly formed. 
Reenter the file specifier. 
ZAP ~- OPEN FAILURE FOR TASK IMAGE FILE 
The file to be modified could not be opened. Possibly it does 
not exist, or is locked, or the device was not mounted, or the 


user does not have write access to the file. 


Check the file specifier for errors; check that the volume is 
properly mounted, check file permissions using PIP. 


ZAP ~~ ERROR ON COMMAND INPUT 
An I/O error occurred while a command was being read. 


Possible hardware error; check hardware and retry command if 
hardware is operational. 
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ZAP -- I/O ERROR ON TASK IMAGE FILE 


An I/O error occurred while reading or writing the file to ke 
modified. 


Possible hardware error; check hardware and retry command if 
hardware is operational. 


ZAP -~ NOT A TASK IMAGE FILE 


An error occurred while the segment description tables were being 
constructed. Possibly, the file is not a task image, /AB was not 
specified, or the task image is defective. 


Reinitiate ZAP and specify the /AB switch in the file specifier. 
ZAP ~~ VERIFY FAILURE 


The V command determined that the actual contents of a location 
did not match the expected contents. 


Error could be in an indirect file or unexpected content in the 
task file. Locate cause of error, correct error, and retry 
command. 
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K.1 COMMAND SUMMARY 
The MAC command string format is as follows: 


objectfile/switch,listfile/switch=sourcel,source2,..., 


sourcen/switch 
where: 
objectfile - object file specifier for the object file output 
of compliation in the format: 

dev: [UIC] filename.typ;ver 

listfile ~ listing file in the format: 
dev: [UIC] filename.typ;ver 

source - input source file specifier in the format 
dev: [UIC] filename.typ;ver 

/switch - assembler control switch. Section 7.3 contains a 


summary of the assembler control switches and 
their descriptions. 


K.1.1 Summary Of Macro Assembler Control Switches 


K.1.2 Listing Control Switches 


The following switches may only appear in the Listfile specifier. 


Switch Function 
/Ul:arg Printed listing requested 
/NL: arg No printed listing requested 
NOTE 


The optional values for ":arg" are described in 
Table K-l. 


K-1 
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Table K-l 
Argument Values for Listing Control Switches 


Controls the listing of source line sequence 
numbers. Error flags are normally printed on 
the line preceding the questionable source 
statement. 


Controls the listing of the location counter 
(this field would not normally be 
suppressed). 


Controls the listing of the generated binary 
code. 


Controls listing of binary extensions; that 
is, those locations and binary contents 
beyond the source statement. This is a 
subset of the BIN argument. 


Controls the listing of the source code. 


Controls the listing of comments. This is a 
subset of the SRC argument and can be used to 
reduce listing time and/or space where 
comments are unnecessary. 


Controls listing of macro definitions and 
repeat range expansions. 


Controls the listing of Macro calls and 
repeat range expansions. 


Controls listing of macro expansions. 


Controls listing of macro expansion binary 
code. A LIST MEB' causes only those macro 
expansion statements producing binary code to 
be listed. This is a subset of the ME 
argument. 


Controls the listing of unsatisfied 
conditions and all .IF and .ENDC statements. 
This argument permits conditional assemblies 
to be listed without including unsatisfied 
code. 


no list Controls listing of all listing directives 
having no arguments (those used to alter the 
listing level count). 


Controls listing of table of contents on pass 
1 of the assembly. The full assembly listing 
is printed during pass 1 of the assembly. 
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Table K-1 (cont) 
Argument Values for Listing Control Switches 


Console Controls listing output format. The TIM 
mode argument (the default case) causes output 
lines to be truncated to 72 characters. 
Binary code is printed with the binary 
extensions below the first binary word. The 
alternative (.NLIST TTM) to Teletype mode is 


line printer mode. 


Controls the listing of the symbol table for 
the assembly. 


MACRO-11 ASSEMBLER COMMAND SUMMARY AND ERROR MESSAGES 


K.1.3 Function Control Switches 


The following switches may only be appended to the objectfile 
specifier. 


Switch Purpose 

/EN:arg Enable the function specified as "arg". 

/DS:arg Disable the function specified as "arg". 
NOTE 


The optional values for "arg" are described in Table K-2. 
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Table K-2 
Function Control Arguments 


Enabling of this function produces’ absolute 
binary output; i.e., input to the Paper Tape 
Software System Absolute Loader. 


disable Enabling of this function directs the 
assembly of all relative addresses (address 
mode 67) as absolute addresses (address mode 
37). This switch is useful during the 
debugging phase of program development. 


The statement .ENABL CDR causes source 
columns 73 and greater to be treated as 
comment. This accommodates sequence numbers 
in card columns 73-80. 


disable Enabling of this function causes 
floating-point truncation, rather than 
rounding, aS is otherwise performed. . DSABL 


FPT returns to floating point rounding mode. 


disable Enabling of this function causes the 
Assembler to accept lower case ASCII input 
instead of converting it to upper case. 


disable Enable or disable a local symbol block. 
While a local symbol block is normally 
entered by encountering a new symbolic label 
or .PSECT directive, .ENABL LSB forces a 
local symbol block which is not’ terminated 
until a label or a .PSECT directive following 
the .DSABL LSB statement is encountered. 


The statement .DSABL PNC inhibits binary 
output until an .ENABL PNC is encountered. 


The statement .DSABL REG inhibits the default 
register definitions. That is, until .DSABL 
REG is seen, the following code is implied as 
being present: 


RO=30 
R1=31 
R2=%2 
R3=%33 
R4=%34 
R5=%5 
SP=%6 
PC=37 


The .ENABL REG statement may be used _ to 
re-enable these definitions. Such use is not 
recommended. 


enable The statement .DSABL GBL inhibits attempts to 
resolve references which remain undefined at 
the end of pass 1, as being global 
references. 
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K.1.4 Assembler Control Switches 


MAC 


MAC 


MAC 


MAC 


Switch Function 

/PA:1 Assemble file during Pass 1 only 

/PA:2 Assemble file during pass 2 only 
NOTE 


The above switches apply only to the sourcefile 
specifier. 


/SP Spool output (default) 
/~-SP Do not spool output 
NOTE 


The above switches apply only to the listingfile 
specifier. 


MAC ERROR MESSAGES 
-- COMMAND I/O ERROR 


An error has been returned by the file system during MACRO-ll's 
attempt to read a command line. This is an unconditionally fatal 
error, causing MACRO-11 to exit to the Executive. No MACRO-11 
restart is attempted when this message appears. 


~~ COMMAND SYNTAX ERROR 


An error has been detected in the syntax of the MACRO-11 command 
line. 


-~- ILLEGAL FILENAME 


Neither the device name nor the filename is present in the input 
file specifier (i.e., the input file specifier is null), or a 
wildcard convention (asterisk) is employed in an input or output 
file specification. Wildcard specifiers (*) are not permitted in 
MACRO-11 file specifiers. 


-~ ILLEGAL SWITCH 


An illegal switch is specified for a file, an illegal value is 
specified with a switch, or an invalid use of a switch has been 
detected by MACRO-1l1. 


MAC 


MAC 


MAC 


MAC 


MAC 


MAC 


MAC 


MAC 


MAC 


MAC 
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-- INDIRECT COMMAND SYNTAX ERROR 


The name of the indirect command file (@filename) specified in 
the MACRO-11 command line is syntactically incorrect. 


~~ INDIRECT FILE DEPTH EXCEEDED 


More than one indirect command file (@filename) is specified in 
the MACRO-11l command line. (Only one level of indirect command 
files is permitted in MACRO-11.) 


~~ INDIRECT FILE OPEN FAILURE 


The indirect command file specified as "“@filename" in the 
MACRO-11 command line does not exist. 


~~ INVALID FORMAT IN MACRO LIBRARY 


The library file has been corrupted or it was not produced by the 
Librarian Utility Program (LBR). 


~~ I/O ERROR ON INPUT FILE 


In reading a record from a source input file or macro library 
file, an error was detected by the file system, e.g., a line 
containing more than 132(10) characters is encountered. This 
message may also indicate that a device problem exists or that 
either a source file or a macro library file has been corrupted 
with incorrect data. 


~~ I/O ERROR ON MACRO LIBRARY FILE 


Same meaning as I/O ERROR ON INPUT FILE, except that the file is 
a macro library file and not a source input file. 


~~ I/O ERROR ON OUTPUT FILE 
In writing a record to the object output file or the listing 
output file, an error was detected by the file system. This 
message may also indicate that a device problem exists or that 
the storage space on a device has been exhausted (i.e., the 
device is full). 
~- OPEN FAILURE ON INPUT FILE 


The file specified as "filename" in the input file specifier does 
not exist. 


~~ OPEN FAILURE ON OUTPUT FILE 
MACRO-11 is unable to create the specified output file. 
~~ SYMBOL TABLE OVERFLOW 


Available symbol table space in dynamic memory has been exceeded. 
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L.1 TKB COMMAND SUMMARY 
The TKB command string format is as follows: 


image [/switch(es)],map,[/switch(es) ] symbol [/switch(es) ]=input/switch (es) 


where: 
image is the relocatable executable task file (.TSK 
file) in the format: 
dev: [UIC] filename.typ;ver 
map is the listing device in the format: 
dev: 
symbol is the STB file which contains all the global 
symbols defined in this task. This file has the 
format: 
dev: [UIC] filename.typ;ver 
input is the .OBJ file to be task built in the format: 
dev: [UIC] filename.type;ver 
/switch(es) is one or more of the TKB control switches. 
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L.1.1 TKB File Switches 


Table L-l 
Task Image File Switches 


2 OSS ae The task is abortable. /AB is assumed. 


The task is checkpointable. /-CP (not checkpointable) 
is assumed. 


A debugging aid is to be loaded with the task. This 
switch causes ODT.OBJ, which resides in the system area 
(S¥:{1,1],) to be automatically included in the task 
image. /-DA is assumed. 


The task image includes a header. /HD is assumed. 
The task is multiuser. /-MU is assumed. 


The task contains only position-independent code. 
is assumed. 


The segments in the task image file are constructed of 
P-sections in the order in which they were encountered 
during input file processing. The default, /-~SQ, 
causes the segments to be constructed alphabetically by 
P-section name. 


The task is accountable. /-TA is assumed. 


The processor T bit is to be set in the initial PS word 
of the task. /-TR is assumed. 


/XTen Exit after any n diagnostics are produced. /~XT 


assumed. 


Tf no switches are specified, 
following default attributes: 


the resultant task image file has_ the 


/ AB ,/CP,/-DA,/DS,/-FP,/FX,/HD,/-MU/-PI 1/~PR,/-SQ,/-TA,/-TR,/-XT 


Memory Allocation Map File Switches 


Produce a cross reference listing. /-CR is assumed. 
Produce a short map. /-SH is assumed. 


Spool the memory allocation file. /SP is assumed. 
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Table L-1l (cont) 
Task Image File Switches 


Symbol Definition File Switches 


The task image contains only position-independent code. 
Therefore, the symbol definition file is written as a 
relocatable file (i.e., the symbol definitions may be 
relocated). /-PI is assumed. 


Input Object File Switches 


The specified file contains concatenated object files. 
Note that when /CC is used, it results in an additional 
pass of the object file and, therefore, should be’ used 
judiciously. 


The specified file contains a debugging aid (e.g., ODT) 
transfer address. This switch must’ be included to 
specify a debugging aid with a transfer address as an 
input file. It is included so that experimental or 
private copies of debugging aids other than ODT may be 
included in the task image. 


The specified file contains a user relocatable library 
(as built by the RSX-11D Librarian; refer to Part II 
of this manual). This library will be searched to 
resolve undefined global symbols. 


The specified file contains an overlay description of 
the Task to be built. If this switch is present, it 
must appear on the first input file specification. See 
below. 


Perform selective symbol search. /-SS is assumed. 


TKB>/MP 


ENTER OPTIONS: 


TKB> 


; OPTIONS 


TKB>/ 
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OPTIONS: 

ABBRT = ANY DIGIT -~ ABORT THE BUILD 
ABSPAT = SGNAM: PADDR: VALUE: VALUE:...:VALUE 
ACTFIL = NUM 


ASG = devnamzunitz:unit:...:unit 


ASG default assignments: 
Symbolic LUN 


SY0 
SY0 
SY0 
sY0 
EL 
CL 


Ot & WD FF 


BASE = BOUND 


COMMON = CNAME:ACCESS:APR 

EXTSCT = CNAME: LENGTH 

EXTTSK = TASK EXTENSION 

FMTBUF = BUFFER EXTENSION 

GBLDEF = SNAME: VALUE 

GBLPAT = SGNAM:SNAME+OFFSET: VALUE: VALUE:...: VALUE 


LIBR = LNAME:ACCESS:APR 

MAXBUF = MAXIMUM RECORD BUFFER SIZE 
ODTV = SNAME: LENGTH 

PAR = PNAME 

POOL = PNUM 

PRI = PNUM 

STACK = SNUM 


TASK 


TASKNAME 


TSKV = ADDRESS OF TASK SST VECTOR 


UIC = [PROJ,PROG] 
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UNITS = NUNIT 


” 


L.2 TKB ERROR MESSAGES 


The Task Builder produces diagnostic and fatal error messages. Error 
messages are printed in the following forms: 


TKB -- *DIAG*~error-message 
or 
TKB ~~ *FATAL*-~error-message 
Some errors are dependent upon correction from the terminal. If the 


user is entering text at the terminal, a diagnostic error message can 
be printed, the error corrected, and the task building sequence 
continued. If the same error is detected by the Task Builder in an 
indirect file, the Task Builder cannot request correction and thus the 
error is termed fatal and the task build is aborted. 


Some diagnostic error messages are simply informative and advise _ the 
user of an unusual condition. If the user considers the condition 
normal to his task, he can install and run the task image. 


This appendix tabulates the error messages produced by the Task 
Builder. Most of the error messages are self-explanatory. The Task 
Builder prints the text shown in this manual in upper case letters. 
In some cases, the Task Builder prints the line in which the error 
occurred, so that the user can examine the line which caused _ the 
problem and correct it. 


0. ILLEGAL GET COMMAND LINE ERROR 
System error. (No recovery.) 


1. COMMAND SYNTAX ERROR 
invalid-line 


The invalid-line printed has incorrect syntax. 
2. REQUIRED INPUT FILE MISSING 
At least one file is required for a task build. 


3. ILLEGAL SWITCH 
invalid-line 


The invalid line printed contains an illegal switch or switch 
value. 


4. NO DYNAMIC STORAGE AVAILABLE 


The Task Builder needs additional symbol table storage and 
cannot obtain it. The input has exceeded the Task Builder's 
capability. 


10. 
a De 


£2. 
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14. 


15. 
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ILLEGAL ERROR/SEVERITY CODE 
System error. (No recovery.) 
COMMAND I/O ERROR 


I/O error on command input device. (Device may not be online 
Or possible hardware error.) 


INDIRECT FILE OPEN FAILURE 
invalid-line 


The invalid-line contains a reference to a command input file 
which could not be located. 


INDIRECT COMMAND SYNTAX ERROR 
invalid-line 


The invalid-line printed contains a syntactically incorrect 
indirect file specification. 


MAXIMUM INDIRECT FILE DEPTH EXCEEDED 
invalid-line 


The invalid-line printed gives the file reference’ that 
exceeded the permissible indirect file depth (2). 


I/O ERROR ON INPUT FILE file-name 
OPEN FAILURE ON FILE file-name 
SEARCH STACK OVERFLOW ON SEGMENT segment-name 


The segment segment-name is more than 16 branch segments from 
the root segment. 


PASS CONTROL OVERFLOW AT SEGMENT segment-name 


The segment segment-name is more than 16 branch segments from 
the root segment. 


FILE file-name HAS ILLEGAL FORMAT 


The file file-name contains an object module whose format is 
not valid. 


MODULE module-name AMBIGUOUSLY DEFINES P-SECTION p-sect-name 


The p-section p-sect-name has been defined in two modules not 
on a common path and referenced ambiguously. 
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MODULE module~name MULTIPLY DEFINES P-SECTION p-sect-name 


1. The p-section p-sect-name has been defined in the same 
segment with different attributes. 


2. A global p-section has been defined in more than one 
segment along a common path with different attributes. 


MODULE module-name MULTIPLY DEFINES XFR ADDR IN SEG 
segment~name 


This error occurs when more than one module comprising’ the 
root has a start address. 


MODULE module-name ILLEGALLY DEFINES XFR ADDRESS p~sect~-name 
addr 


The module module-name is in an overlay segment and has a 
start address. The start address must be in the root segment 
of the main tree. 

P-SECTION p-sect~name HAS OVERFLOWED 

A section greater than 32K has been created. 


MODULE module-name AMBIGUOUSLY DEFINES SYMBOL sym-name 


Module module-name references or defines a symbol sym-name 
whose definition cannot be uniguely resolved. 


MODULE module-name MULTIPLY DEFINES SYMBOL sym-name 


Two definitions for the relocatable symbol sym-name have 
occurred on a common. path. Or two definitions for an 
absolute symbol with the same name but different values have 
occurred. 
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24. 


25. 


26. 
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SEGMENT seg-name HAS R-O SECTION 

An attempt has been made to allocate a read-only p-section in 
an overlay segment. The build continues with R-W attribute 
forced. 

SEGMENT seg~name HAS ADDR OVERFLOW: ALLOCATION DELETED 
Within a segment, the program has attempted to allocate more 
than 32K. A map file is produced, but no task image file is 
produced. 

ALLOCATION FAILURE ON FILE file-name 

The Task Builder could not acguire sufficient contiguous disk 
space to store the task image file. (If possible, delete 
unnecessary files on disk to make more room available.) 

I/O ERROR ON OUTPUT FILE file-name 

This error may occur on any of the three output files. 


LOAD ADDR OUT OF RANGE IN MODULE module-name 


An attempt has been made to store data in the task image 
outside the address limits of the segment. 


TRUNCATION ERROR IN MCDULE module-name 

An attempt has been made to load a global value greater than 
+127 or less that -128 into a byte. The low-order eight bits 
are loaded. 


number UNDEFINED SYMBOLS SEGMENT seg-name 


The Memory Allocation File lists each undefined symbol by 
segment. 


INVALID KEYWORD IDENTIFIER 
invalid-line 


The invalid-line printed contains an unrecognizable keyword. 


OPTION SYNTAX ERROR 
invalid-line 


The invalid-line printed contains unrecognizable syntax. 


TOO MANY PARAMETERS 
invalid-line 


The invalid-line printed contains a keyword with more 
parameters than required. 


ILLEGAL MULTIPLE PARAMETER SETS 
invalid-line 


The invalid-line printed contains multiple parameters for a 
keyword which only allows a single parameter. 
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39. 


40. 


41. 


42. 
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INSUFFICIENT PARAMETERS 
invalid-line 


The invalid-line contains a keyword with an insufficient 
number of parameters to complete the keyword meaning. 


TASK HAS ILLEGAL MEMORY LIMITS 


An attempt has been made to build a task whose size exceeds 
the partition boundary. 


OVERLAY DIRECTIVE HAS NO OPERANDS 
invalid-line 


All overlay directives except .END require operands. 


ILLEGAL OVERLAY DIRECTIVE 
invalid-line 


The invalid-line printed contains an unrecognizable overlay 
directive. 


OVERLAY DIRECTIVE SYNTAX ERROR 
invalid-line 


The invalid-line printed contains a syntax error. 


ROOT SEGMENT MULTIPLY DEFINED 
invalid-line 


The invalid-line printed contains the second .ROOT directive 
encountered. Only one .ROOT directive is allowed. 


LABEL OR NAME IS MULTIPLY DEFINED 
invalid-line 


The invalid-line printed contains a name that has already 
appeared on a .FCTR, .NAME, or .PSECT directive. 


NO ROOT SEGMENT SPECIFIED 
The overlay description did not contain a .ROOT directive. 


BLANK P~-SECTION NAME IS ILLEGAL 
invalid-line 


The invalid-line printed contains a .PSECT directive that 
does not have a p-section name. 


ILLEGAL P~SECTION ATTRIBUTE 
invalid-line 


The invalid-line printed contains a p-section attribute that 
is not recognized. 
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TLLEGAL OVERLAY DESCRIPTION OPERATOR 
invalid-line 


The invalid-line printed contains an unrecognizable operator 
in an overlay description. 


TOO MANY NESTED .ROOT/.FCTR DIRECTIVES 
invalid-line 


The invalid-line printed contains a .FCTR directive that 
exceeds the maximum nesting level (32). 


TOO MANY PARENTHESES LEVELS 
invalid-line 


The invalid-line printed contains a parenthesis that exceeds 
the maximum nesting level (32). 


UNBALANCED PARENTHESES 
invalid-line 


The invalid-line printed contains unbalanced parentheses. 
ILLEGAL BASE OR TOP ADDRESS OFFSET 


The task is too large to fit into the space allowed by BASE= 
or TOP= keywords. 


ILLEGAL LOGICAL UNIT NUMBER 

invalid-line 

The invalid-line printed contains a device assignment to a 
unit number larqer than the number of logical units specified 
by the UNITS keyword or assumed by default if the UNITS 
keyword is not used. 


ILLEGAL NUMBER OF LOGICAL UNITS 
invalid-line 


The invalid-line printed contains a number of logical unit 
greater that 250. 


ILLEGAL NUMBER OF ACTIVE FILES SPECIFIED 


ILLEGAL BASE OR TOP BOUNDARY VALUE 
invalid line 


ILLEGAL POOL USAGE NUMBER SPECIFIED 
invalid line 


The pool request is greater than 255 or it is zero. 


ILLEGAL DEFAULT PRIORITY SPECIFIED 
invalid-line 


The invalid-line printed contains a priority greater than 
250. 


L-10 


54. 


25 « 


56. 


Dis 


58. 


39% 


60. 


61. 


TKB COMMAND SUMMARY AND ERROR MESSAGES 


ILLEGAL ODT OR TASK VECTOR SIZE 
SST vector size specified greater than 32 words. 


ILLEGAL FILENAME 
invalid-line 


The invalid-line printed contains a wild card (*) in a file 
specification. The use of wild cards is prohibited. 


ILLEGAL DEVICE/VOLUME 
invalid line 


The device/volume string is too long. 


LCOKUP FAILURE ON FILE filename 
invalid-line 


The invalid-line printed contains a filename which cannot be 
located in the directory. 


ILLEGAL DIRECTORY 
invalid-line 


The invalid-line printed contains an illegal UFD. 
INCOMPATIBLE REFERENCE TO A LIBRARY P-SECTION p-sect-name 

A task has attempted to reference more storage in a shareable 
global area than exists in the shareable global area 
definition. 

ILLEGAL REFERENCE TO LIBRARY P~-SECTION p-~sect-—name 

A task has attempted to reference a p-sect~-name existing in a 
resident library (shareable global area) but has not named 


the library in a COMMON or LIBR keyword. 


RESIDENT LIBRARY MEMORY ALLOCATION CONFLICT 
keyword-string 


One of the following problems has occurred: 


l. More than three shareable global areas have been 
specified. 


2. The same shareable global area has been specified more 
than once. 


3.  Shareable global areas whose memory allocations overlap 
have been specified. 


4. BASE or TOP specifications conflict. 
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LOOKUP FAILURE RESIDENT LIBRARY FILE 
invalid-line 


No symbol table or task image file found ffor the shareable 
global area on SYO under UFD [1,1]. 


INVALID ACCESS TYPE 
invalid-line 


Requested access to shareable global area was not RW or RO. 


ILLEGAL PARTITION/COMMON BLOCK SPECIFIED 
invalid-line 


User defined base or length not on 32 word bound or_ user 
defined length = 0. 


NO MEMCRY AVAILABLE FOR LIBRARY library~name 


Insufficient virtual memory available to cover total memory 
needed by referenced shareable global areas. 


PIC LIBRARIES MAY NOT REFERENCE OTHER LIBRARIES 
invalid-line 


ILLEGAL APR RESERVATION 


APR specified on COMMON or LIBR keyword that is outside the 
range 0-7. 


I/O ERROR LIBRARY IMAGE FILE 


An I/O error has occurred during an attempt to open or read 
the Task Image File of a shareable global area. 


LIBRARY REFERENCES UNDEFINED LIBRARY 


A shareable global area specified by LIBR Or COMMON 
references another area which is undefined. 


not used. 
INVALID APR RESERVATION 


APR specified on a LIBR or COMMON keyword for an absolute 
shareable global area. 


COMPLEX RELOCATION ERROR - DIVIDE BY ZERO: MODULE 
module-~name 


A divisor having the value zero was detected in a complex 


expression. The result of the divide was set to zero. 
(Probable cause - division by an undefined global symbol.) 
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WORK FILE T/O ERROR 

I/C error during an attempt to reference data stored by the 
Task Builder ina work file. Possibly an attempt to extend 
the file when no more space is available on the volume. 


LOOKUP FAILURE ON SYSTEM LIBRARY FILE 


The Task Builder cannot find the _ system Library 
(SY0:[1,1]SYSLIB.OLB) file to resolve undefined symbols. 


UNABLE TO OPEN WORK FILE 


Work file device is not mounted or has not been initialized 
as Files-ll, or there is no space on the volume. 


NO VIRTUAL MEMORY STORAGE AVATLABLE 


Maximum permissible size of the work file exceeded (no 
recovery). 


MCDULE mocule-name NOT IN LIBRARY 


The Task Builder could not find the module namea on the LB 
switch in the library. 


INCORRECT LIBFARY MODULE SPECIFICATION 
invalid-line 


The invalid-line contains a module name with a non-Radix-50 
character. 


LIBRARY FILE filename HAS INCORRECT FORMAT 


A module has been requested from a library file that has an 
empty module name table. 


RESIDENT LIBRARY IMAGE HAS INCORRECT FORMAT 
invalid-line 


The invalid-line specifies a shareable global area that has 
one of the following problems: 


1. The library file image has a header. 

2. The shareable global area references another’ shareable 
global area with invalid address bounds (i.e., not on 4K 
boundary). 


3. The shareable global area has invalid address bounds. 
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PARTITION partition-name HAS ILLEGAL MEMORY LIMITS 


The user has attempted to build a privileged task whose 
length exceeds 16K. 


not used. 


ABORTED VIA REQUEST 
input~line 


The input-line contains a request from the user to abort the 
task build. 


not used 
END OF FILE REACHED BEFORE .END DIRECTIVE IN file-name 


The overlay description file named in this message does not 
contain a .END directive as required. 
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M.1 COMMAND SUMMARIES 
SCOBOL 

SCOBCL[/sws] [src/SOURCE] [obj/OBJECT] [list/LIST] [!comments] 
SCOPY 


SCOPY [dev:]filename.type/OUTPUT [dev:]filenamel.type [+dev:filename2.type[/INPUT] ] [!comments] 


SCREATE 
SCREATE filename.type [!comments] 
SDATA 
SDATA [!comments] 
SDELETE 
SDELETE filenamel [filename2 ... filenamen] [!comments] 
SDIRECTORY 
SDIR [filename.type/DIRECTORY] [filenamel.typel[/INPUT]] [!comments] 
SDISMOUNT 
SDISMOUNT lun: [!comments] 
SEOD 
SEOD 
SEOJ 
SEOJ 


SFORTRAN 
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SFORTRAN[/sws] [src/sw] [obj/CBJECT] [list/LIST] [!comments] 


$JOB 

SJOB[/switches] [!comments] 
SLINK 

SLINK[/switches] [obj/OBJECT] [lib/LIBRARY] [map/MAP] [task/EXECUTE] [!comments] 
SMACRO 

SMACRO[/sws] [src/SOURCE] [obj /OBJECT] [list/LIst] [!comments] 
SMESSAGE 

SMESSAGE[/WAIT] message 
SMOUNT 

SMOUNT dev[/PHYSICAL] [/switch] [/VOLUME=x] [/VID=x] lun:/LOGICAL [!comments] 
SPRINT 

SPRINT[filespecl [filespec2 ... filespecn] 
$RUN 

SRUN filespec 
SSORT 


SSORT[/sws] [infile/INPUT] [outfile/OUTPUT] [specfile/SPECIFICATION] [!comments] 


M.2 BATCH ERROR MESSAGES 
BAT -- ERROR MISSING JOB CARD 
1. A $JOB card did not follow in sequence after a SEOJ. 
2. A $JOB card was omitted at the beginning of the input file. 


3. The submitted S$JOB command has an error (i.e., MCR mode _ was 
specified from a non-privileged terminal). 


In each of the above cases, the error message is printed and all 
of the images on the input file are flushed until the next valid 
$JOB command is encountered. 


Place a $JOB card or command at the appropriate place or correct 
the erroneous $JOB command and resubmit the job. 


BAT -- ERROR READING INPUT FILE 
A physical error has been encountered while the input job file is 


read, Or an input file contains extraneous records following a 
SEOJ command. 
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Verify, by some copy or editing operation, that the file is error 
free, and resubmit the job. If extraneous records follow an S$EOJ 
but all valid jobs have been processed correctly, delete the 
extraneous records before the next submission of the batch job. 


BAT ~~ ERROR WRITING OUTPUT FILE 


An attempt to issue a write to a disk file has failed due to a 
lack of file space on the disk 


Delete superfluous files and resubmit the job. 
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SYSTEM STANDARD ERROR CODES 


CODE DESCRIPTION 
~01 Unavailable Pool node 
or 


Bad parameters 


-02 Invalid function code 

~03 Device not ready 

-04 Parity error on device 

-05 Un-assigned LUN 

-06 Handler task not resident 
or 


Tllegal user buffer 


-07 Device not attached 

-08 Device already attached 

-09 Device not attachable 

-10 End of file detected 

~li End of volume detected 

-12 - Write attempted to locked unit 
~13 Data overrun 

-—14 Send/Receive failure 

~15 Request terminated 

-16 Privilege violation 

-17 Not used 

-18 Tllegal overlay request 

~-19 Odd byte count (or virtual address) 
~-20 Logical block number too large 


SYSTEM STANDARD ERROR COLES 


CODE DESCRIPTION 

-21 Invalid UDC module # 

-22 UDC connect error 

-23 Caller's nodes exhausted 

~24 Device full 

~25 Index file full 

~26 No such file 

~27 Locked from file access 

-28 File header full 

-29 Accessed for write 

-30 File header checksum failure 

~31 Write attribute data format error 

~32 File processor device read error 

~33 File processor device write error 

—34 File already accessed on LUN 

~35 File ID, file number check 

~36 File ID, seguence number check 

-37 No file accessed on LUN 

-38 File was not properly closed 

=39 Open - No buffer space available for file 

-40 Tllegal record size 

-41 File exceeds space allocated; no space 

~-42 Illegal operation on file descriptor block 

-43 Bad record type 

-44 Illegal record access bit set 

~45 Tllegal record attributes bit set 

~46 Tllegal record number - Too large 

~47 Multiple block Read/Write - not implemented 
yet 

-48 RENAME - 2 different devices 
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CODE DESCRIPTION 
-49 RENAME ~- new file already in use 
~-50 Bad directory file 
~51 Can't rename - old file system 
~52 Bad directory syntax 
~53 File already open 
~54 Bad file name 
-55 Bad device name 
~56 Bad block on device 
~57 ENTER ~— duplicate entry in directory 
-58 Not enough stack space (FCS or FCP) 
~59 Fatal hardware error on device 
-60 File ID was not specified 
~61 Tllegal sequential operation 
~62 End of tape detected 
-63 Bad version number 
-64 
to Unused 
~94 
-95 Invalid priority (>250.) 
-96 Invalid LUN 
-97 Invalid event (>64.) 
~98 Part of DPB out of user's space 
-99 DIC or DPB size invalid 


ABO, 5-2, 6-2 

ABORT command, 5-2, 

Account numbers, 3-8 
ACT, 5-3 

Activating MCR, 4-2 


6-2 


ACTIVE TASK LIST command, 5-3 
ALT, 6-3 
ALTER PRIORITY command, 6-3 
ALTMODE, 3-20 
ANSI standard, 3-4 
BAD, 6-4 
BAD BLOCKS command, 6-4 
BATCH, 1-8 

command summary, M-1 

error messages, M-2 

pseudo device (BP), 3-1, 3-3 
BOO, 6-6 
BOOTSTRAP command, 6-6 
BP, 3-1, 3-3 
BYE, 5-8 
CAN, 6-9 


CANCEL command, 6-9 
Card reader control conventions, 
3-22 
Checkpointing, 
CI, 3-1, 3-3 
CL, 3-1, 3-3 
CO, 3-1, 3-3 
COM, 5-9 
Command, 4-3 
Command line, 
Command string, 
Command syntax, 
Command terminal, 
Common areas, 2-10 
CON, 5-10 


2-8 


4-3 
3-15 
3-15 
4-1 


Console input (CI), 3-1, 3-3 
Console log (CL), 3-1, 3-3 
Console output (CO), 3-1, 3-3 
CONTINUE command, 5-10 


Conventions, 3-l 
3-20 
3-20 
3-20 
3-20 
3-21 
3-21 
3-21 
3-21 
3-21 
3-21 
3-20 


Data pointer, 3-6 


INDEX 


Default file specifiers, 3-15, 3-16 


Default file type, 3-16 
Despooling, 2-9 
dev:, 3-15 
DEV, 5-11 
DEVICES command, 5-11 
Device conventions, 3-1 
Device handler, 1-7 
Device independence, 2-8 
DIS, 6-10 
DISABLE command, 6-10 
DISMOUNT VOLUME command, 
DMO, 5-12, 6-11 
DMP, 1-6 
command summary, D-1l 
error messages, D-l 
Dump utility (DMP), 1-6 
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EDI, 1-5 
command summary, E-1 
error messages, E-6 
Editor (EDI), 1-5 
ENA, 6-12 
ENABLE command, 6-12 
ENTER PASSWORD command, 6-35 
Entering system commands, 4-3 
Error reporting, 4-4 
Examples of command strings, 
Execute form of RUN, 6-43 


3-18 


File 
File 
File 
File 
File 
File 
File 


compression (SQZ), 1-6 
name, 3-5, 3-15 
owner, 3-5 
ownership, 3-8 
protection, 3-6, 
specifiers, 3-15 
structures, 3-4 
File Transfer Program (FLX), 1-5 
File type, 3-5, 3-16 
Files-1ll, 3-4 

format, 3-5 

volumes, 3-5 
FIX, 6-13 
FIX-IN-MEMORY command, 
FLX, 1-5 

command summary, C-1l 

error messages, C-3 
FORTRAN, 1-4 


3-9 


6-13 


General user commands, 5-1 
ABO, 5-2 

ACT, 
BYE, 
COM, 
CON, 
DEV, 
DMO, 
HEL, 
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General 
LOG, 


user commands (cont.), 
5-16 
5-17 
5-18 
5-23 
5-25 
5-26 
5-27 
5-39 
5-40 
5-42 
5-52 
5-53 
5-54 


Group, 3-9 


Hardware error logging, 1-9 
HEL, 5-14 


HELLO command, 5-14 
Indirect files, 3-19 
INI, 6-14 
Initialize tape volumes, 6-14, 
7-1 
INITIALIZE VOLUME command, 6-14 
INS, 6-22 
LBR, 1-6 
command summary, G-1l 
error messages, G-3 


Librarian (LBR), G-3 

LIST COMMON BLOCKS command, 
LOA, 6-27 
LOAD command, 
LOG, 5-16 
Logical unit numbers, 3-4 
LOGICAL UNIT NUMBERS command, 
LUN, 3-4, 5-17 


5-9 


6-27 


5-17 


MACRO Assembler, 1-4 
MACRO-11, 
command summary, K-1l 
control switches, K-1l 
error messages, K-5 
Magnetic tape volumes, 7-1 
MAN option for /BAD keyword, 6-18 
Master file directory, 3-7 
MCR, 4-1 
command summary, A-1l 
error messages, A-10 
MCR timeout, 4-3 
MEM, 6-28 
Memory parity checking, 1-9 
Memory protection, 2-3 
Message Output (MO), 3-1, 
MFD, 3-7 
MO, 3-1, 3-3 
Monitor Console Routine (MCR), 
4-1 


3-3 
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MOU, 5-18, 6-29 

MOUNT command 5-18, 6-29 
Node pool status program, 8-1 
Nonprivileged user, 4-2 
OPE, 6-31 

OPEN REGISTER command, 6-31 
OPERATE command, 5-23, 6-34 
OPR, 5-23, 6-34 

Overlays, 2-4 

Owner, 3-9 

PAR, 5-25 


Partitions, 2-l 
PARTITIONS command, 5-25 
PASSWORD command, 5-26 
Peripheral Interchange Program 
(PIP), 1-5 
PIP, 1-5 
command summary, B-1l 
error codes, B-10 
error messages, B-4 
POOL, 8-1 
Privileged user, 4-2 
Privileged user commands, 
ABO, 6- 
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PROD PW NY 


Gs 
Ge 
BOO, 6- 
6= 
6- 
6- 
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6-13 
6-14 
6-22 
6-27 
6-28 
6-29 
6-31 
6-34 
6-35 
6-36 
6-37 
6-38 
6-40 
6-41 
6-47 
6-52 
6-55 
6-56 
6058 
UNL, 6-59 
Pseudo devices, 
PWD, 5-26, 6-35 
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QUE, 5-27, 6-36 


QUEUE command, 5-27, 6-36 


INDEX-2 


REA, 6-37 
REASSIGN command, 
RED, 6-38 
REDIRECT command, 6-38 
REM, 6-40 
REMOVE command, 6-40 
Request form of RUN, 
RES, 6-39 
RESUME command, 
RETURN, 3-20 
RUBOUT, 3-20 
RUN, 5-40, 6-41 
RUN command, 5-40, 
execute, 6-43 
request, 6-42 
run, 6-44 
schedule, 
synchronize, 


6-37 


6-42 


6-39 


6-41 


6-45 
6-46 


SAVE command, 6-47 
Schedule form of RUN, 
SEND/RECEIVE, 2-11 
SET, 6-52 
SET command, 6-52 
Shareable global areas, 
Shareable libraries, 2-9 
Slave terminal, 4-1 
SLP, 1-6 
command summary, F-l 
error messages, F-1 . 
Source Language Input Program (SLP) 
1-6 


6-45 


2-9 


SP, 3-1, 3-3 
Spooling, 2-9 
Spooling output (SP), 3-1, 3-3 
SQZ, 1-6 
command summary, H-1l 
error messages, H-1 
/switch, 3-15 
SY, 3-1, 3-2 
Synchronize form of RUN, 6-46 
SYS, 5-42 
System commands, 4-3 
System device, 3-1, 3-2 
System generation, 1-8 
System standard error codes, N-1l 


SYSTEM 5-42 


System 


status command (SYS), 
test package, 1-9 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repert (SPR) form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 
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5 Is there sufficient documentation on associated system programs 
: required for use of the software described in this manual? If not, 
2 what material is missing and where should it be placed? 

® 
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Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 
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Non-programmer interested in computer concepts and capabilities 
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